Skip to main content
POST
Add a sender domain

Authorizations

Authorization
string
header
required

An API key, sent as Authorization: Bearer stfy_live_…. See Authentication for how to get one and which scopes it needs.

Body

application/json
domain
string
required

The domain name, such as acme.com. Letter case and a trailing dot don't matter. Statisfy's own sending domains are refused

Required string length: 1 - 300
dkim_selector
string | null

3 letters or digits for the DKIM records' names (s1._domainkey becomes ._domainkey). Left out, SendGrid's default

Maximum string length: 3

Response

Successful Response

added_by
string | null
required

The email of the person who added it

created_at
string<date-time> | null
required
domain
string
required
records
DnsRecord · object[]
required

The DNS records to publish at your DNS provider. Verify checks them; whether each one is found is not returned, only the domain's status

status
enum<string>
required

pending (added, not yet verified), verified (SendGrid found the records; the workspace can send from it) or failed (the last verify did not find them)

Available options:
pending,
verified,
failed
updated_at
string<date-time> | null
required
verified_at
string<date-time> | null
required

When it became verified; null while it is not