Domains

Manage custom email domains for your organization

Create Domain

cURL

curl -X POST https://api.sendook.com/v1/domains \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "yourdomain.com"
  }'

const response = await fetch('https://api.sendook.com/v1/domains', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    name: 'yourdomain.com'
  })
});

const domain = await response.json();

import requests

response = requests.post(
    'https://api.sendook.com/v1/domains',
    headers={
        'Authorization': 'Bearer YOUR_API_KEY',
        'Content-Type': 'application/json'
    },
    json={'name': 'yourdomain.com'}
)

domain = response.json()

Add a custom domain to your organization. After creating a domain, you must configure DNS records and verify the domain before using it with inboxes.

Request Body

name · string · required

The domain name. Must be a valid domain format.

Example: "yourdomain.com"

Valid formats:

• domain.com
• subdomain.domain.com
• mail.company.co.uk

Response

id · string

Unique identifier for the domain.

organizationId · string

ID of the organization that owns this domain.

name · string

The domain name.

verified · boolean

Whether the domain has been verified. Will be false initially.

records · array

Array of DNS record verification status objects.

Show Record Object

type · string

DNS record type (e.g., “MX”, “TXT”, “CNAME”).

value · string

The DNS record value.

status · string

Verification status of this record.

createdAt · string

ISO 8601 timestamp of when the domain was created.

updatedAt · string

ISO 8601 timestamp of when the domain was last updated.

Error Responses

400 Bad Request

• "Invalid domain name format" - The domain name format is invalid

---

List Domains

cURL

curl https://api.sendook.com/v1/domains \
  -H "Authorization: Bearer YOUR_API_KEY"

const response = await fetch('https://api.sendook.com/v1/domains', {
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY'
  }
});

const domains = await response.json();

import requests

response = requests.get(
    'https://api.sendook.com/v1/domains',
    headers={'Authorization': 'Bearer YOUR_API_KEY'}
)

domains = response.json()

Retrieve all domains for your organization.

Response

Returns an array of domain objects.

id · string

Unique identifier for the domain.

organizationId · string

ID of the organization that owns this domain.

name · string

The domain name.

verified · boolean

Whether the domain has been verified.

records · array

Array of DNS record verification status objects.

createdAt · string

ISO 8601 timestamp of when the domain was created.

updatedAt · string

ISO 8601 timestamp of when the domain was last updated.

---

Get Domain

cURL

curl https://api.sendook.com/v1/domains/yourdomain.com \
  -H "Authorization: Bearer YOUR_API_KEY"

const response = await fetch('https://api.sendook.com/v1/domains/yourdomain.com', {
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY'
  }
});

const domain = await response.json();

import requests

response = requests.get(
    'https://api.sendook.com/v1/domains/yourdomain.com',
    headers={'Authorization': 'Bearer YOUR_API_KEY'}
)

domain = response.json()

Retrieve a specific domain by its name.

Path Parameters

domainId · string · required

The domain name (used as the identifier).

Example: "yourdomain.com"

Response

id · string

Unique identifier for the domain.

organizationId · string

ID of the organization that owns this domain.

name · string

The domain name.

verified · boolean

Whether the domain has been verified.

records · array

Array of DNS record verification status objects.

createdAt · string

ISO 8601 timestamp of when the domain was created.

updatedAt · string

ISO 8601 timestamp of when the domain was last updated.

Error Responses

404 Not Found

• "Domain not found" - The domain doesn’t exist or doesn’t belong to your organization

---

Get DNS Records

cURL

curl https://api.sendook.com/v1/domains/yourdomain.com/dns \
  -H "Authorization: Bearer YOUR_API_KEY"

const response = await fetch('https://api.sendook.com/v1/domains/yourdomain.com/dns', {
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY'
  }
});

const dnsRecords = await response.json();

import requests

response = requests.get(
    'https://api.sendook.com/v1/domains/yourdomain.com/dns',
    headers={'Authorization': 'Bearer YOUR_API_KEY'}
)

dns_records = response.json()

Get the required DNS records that need to be configured for domain verification. Add these records to your domain’s DNS settings.

Path Parameters

domainId · string · required

The domain name.

Example: "yourdomain.com"

Response

Returns an array of DNS record objects that must be added to your domain.

type · string

The DNS record type.

Values: MX, TXT, CNAME

name · string

The DNS record name/host.

• @ represents the root domain
• For subdomains, this will be the subdomain prefix
• For DKIM records, this will be a specific token subdomain

value · string

The DNS record value/target.

priority · number

Priority value for MX records.

Only present for MX records.

DNS Records Explained

MX Record

Purpose: Routes incoming emails to AWS SES

Configuration:

• Type: MX
• Name: @ (or subdomain prefix)
• Value: inbound-smtp.us-east-2.amazonaws.com
• Priority: 10

SPF Record

Purpose: Prevents email spoofing by authorizing AWS SES to send emails from your domain

Configuration:

• Type: TXT
• Name: @ (or subdomain prefix)
• Value: v=spf1 include:amazonses.com ~all

DMARC Record

Purpose: Defines how receiving servers should handle emails that fail authentication

Configuration:

• Type: TXT
• Name: _dmarc (or _dmarc.subdomain)
• Value: v=DMARC1; p=reject;

DKIM Records

Purpose: Digital signature verification to prove emails are authentic and unmodified

Configuration:

• Type: CNAME
• Name: [token]._domainkey.yourdomain.com
• Value: [token].dkim.amazonses.com

Multiple DKIM records will be provided (typically 3).

Error Responses

400 Bad Request

• "Failed to get DKIM attributes" - Unable to retrieve DKIM tokens from AWS SES

404 Not Found

• "Domain not found" - The domain doesn’t exist or doesn’t belong to your organization

---

Verify Domain

cURL

curl -X POST https://api.sendook.com/v1/domains/yourdomain.com/verify \
  -H "Authorization: Bearer YOUR_API_KEY"

const response = await fetch('https://api.sendook.com/v1/domains/yourdomain.com/verify', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY'
  }
});

const verifiedDomain = await response.json();

import requests

response = requests.post(
    'https://api.sendook.com/v1/domains/yourdomain.com/verify',
    headers={'Authorization': 'Bearer YOUR_API_KEY'}
)

verified_domain = response.json()

Verify that the required DNS records have been properly configured. This checks AWS SES to confirm domain verification status.

DNS changes can take up to 48 hours to propagate. If verification fails, wait and try again later.

Path Parameters

domainId · string · required

The domain name to verify.

Example: "yourdomain.com"

Response

Returns the updated domain object with verification status.

id · string

Unique identifier for the domain.

organizationId · string

ID of the organization that owns this domain.

name · string

The domain name.

verified · boolean

Whether the domain has been successfully verified.

Will be true if verification succeeded, false otherwise.

records · array

Array of DNS record verification status objects showing which records passed or failed verification.

createdAt · string

ISO 8601 timestamp of when the domain was created.

updatedAt · string

ISO 8601 timestamp of when the domain was last updated.

Error Responses

404 Not Found

• "Domain not found" - The domain doesn’t exist or doesn’t belong to your organization

---

Delete Domain

cURL

curl -X DELETE https://api.sendook.com/v1/domains/yourdomain.com \
  -H "Authorization: Bearer YOUR_API_KEY"

const response = await fetch('https://api.sendook.com/v1/domains/yourdomain.com', {
  method: 'DELETE',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY'
  }
});

const deletedDomain = await response.json();

import requests

response = requests.delete(
    'https://api.sendook.com/v1/domains/yourdomain.com',
    headers={'Authorization': 'Bearer YOUR_API_KEY'}
)

deleted_domain = response.json()

Delete a custom domain from your organization.

Deleting a domain will prevent any inboxes using this domain from sending or receiving emails. Make sure to update or delete affected inboxes first.

Path Parameters

domainId · string · required

The domain name to delete.

Example: "yourdomain.com"

Response

Returns the deleted domain object.

id · string

Unique identifier for the deleted domain.

organizationId · string

ID of the organization that owned this domain.

name · string

The domain name.

verified · boolean

Whether the domain was verified before deletion.

records · array

Array of DNS record verification status objects.

createdAt · string

ISO 8601 timestamp of when the domain was created.

updatedAt · string

ISO 8601 timestamp of when the domain was last updated.

Error Responses

404 Not Found

• "Domain not found" - The domain doesn’t exist or doesn’t belong to your organization