POST
/
v1
/
domains
curl --request POST \
  --url https://app.unsend.dev/api/v1/domains \
  --header 'Content-Type: application/json' \
  --data '{
  "name": "<string>",
  "region": "<string>"
}'
{
  "id": 1,
  "name": "example.com",
  "teamId": 1,
  "status": "NOT_STARTED",
  "region": "us-east-1",
  "clickTracking": false,
  "openTracking": false,
  "publicKey": "<string>",
  "dkimStatus": "<string>",
  "spfDetails": "<string>",
  "createdAt": "<string>",
  "updatedAt": "<string>",
  "dmarcAdded": false,
  "isVerifying": false,
  "errorMessage": "<string>",
  "subdomain": "<string>"
}

Body

application/json
​
name
string
required
​
region
string
required

Response

200 - application/json
Create a new domain
​
id
number
required

The ID of the domain

Example:

1

​
name
string
required

The name of the domain

Example:

"example.com"

​
teamId
number
required

The ID of the team

Example:

1

​
status
enum<string>
required
Available options:
NOT_STARTED,
PENDING,
SUCCESS,
FAILED,
TEMPORARY_FAILURE
​
publicKey
string
required
​
createdAt
string
required
​
updatedAt
string
required
​
region
string
default:us-east-1
​
clickTracking
boolean
default:false
​
openTracking
boolean
default:false
​
dkimStatus
string | null
​
spfDetails
string | null
​
dmarcAdded
boolean
default:false
​
isVerifying
boolean
default:false
​
errorMessage
string | null
​
subdomain
string | null