Skip to main content
POST
/
domains
Create a domain
curl --request POST \
  --url https://api.sendkit.dev/domains \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "yourdomain.com",
  "region": "us-east-1",
  "open_tracking": true,
  "click_tracking": true,
  "tls": "opportunistic"
}
'
{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "name": "yourdomain.com",
  "status": "verified",
  "region": "us-east-1",
  "open_tracking": true,
  "click_tracking": true,
  "tls": "opportunistic",
  "sending_enabled": true,
  "dns_records": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "record_type": "DKIM",
      "name": "sendkit._domainkey.yourdomain.com",
      "value": "v=DKIM1; k=rsa; p=MIGfMA0...",
      "ttl": 3600,
      "status": "verified",
      "priority": 10,
      "created_at": "2026-03-03 10:00:00",
      "updated_at": "2026-03-03 10:00:00"
    }
  ],
  "created_at": "2026-03-03 10:00:00",
  "updated_at": "2026-03-03 10:00:00"
}

Authorizations

​
Authorization
string
header
required

API key from your SendKit dashboard. Pass it as a Bearer token in the Authorization header.

Body

application/json
​
name
string
required

The domain name to add.

Maximum string length: 255
Example:

"yourdomain.com"

​
region
string
required

The AWS region for the domain. Must be a region with available capacity.

Example:

"us-east-1"

​
open_tracking
boolean
default:false

Enable open tracking. Defaults to false.

Example:

true

​
click_tracking
boolean
default:false

Enable click tracking. Defaults to false.

Example:

true

​
tls
enum<string>
default:opportunistic

TLS delivery mode. Defaults to opportunistic.

Available options:
opportunistic,
enforced
Example:

"opportunistic"

Response

Domain created successfully

​
id
string<uuid>

Unique identifier.

Example:

"550e8400-e29b-41d4-a716-446655440000"

​
name
string

The domain name.

Example:

"yourdomain.com"

​
status
enum<string>

The current verification status of the domain.

Available options:
not_started,
pending,
verified,
partially_verified,
failed,
temporary_failure
Example:

"verified"

​
region
string

The AWS region where the domain is configured.

Example:

"us-east-1"

​
open_tracking
boolean

Whether open tracking is enabled.

Example:

true

​
click_tracking
boolean

Whether click tracking is enabled.

Example:

true

​
tls
enum<string>

The TLS delivery mode.

Available options:
opportunistic,
enforced
Example:

"opportunistic"

​
sending_enabled
boolean

Whether sending is enabled for this domain.

Example:

true

​
dns_records
object[]

The DNS records that need to be configured for this domain.

​
created_at
string<date-time>

When the domain was created.

Example:

"2026-03-03 10:00:00"

​
updated_at
string<date-time>

When the domain was last updated.

Example:

"2026-03-03 10:00:00"