Skip to main content
POST
Add owned domain

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
domain
string
required

The domain to prove ownership of, e.g. acme.com.

Required string length: 4 - 253

Response

Domain added; publish the TXT record, then verify

Domain added; publish the TXT record, then verify

id
string

Owned domain ID

domain
string

The domain your organisation controls, e.g. acme.com. Subdomains are covered too.

status
enum<string>

pending — added, TXT record not yet seen. verified — recipients on this domain are not metered as cold outreach. failed — the record was verified before and has since disappeared; publish it again and call verify.

Available options:
pending,
verified,
failed
record
object

The one TXT record to publish to prove ownership.

verifiedAt
string<date-time> | null
checkedAt
string<date-time> | null

When the record was last looked up, whatever the result.

createdAt
string<date-time>