WoyraDocs
Get an API key

Add a sending domain

POST/v1/domains

Domains · Requires an API key

Registers a domain, generates its DKIM key, and returns the DNS records to publish — ready to paste, with the exact values and an explanation of what each one does.

Sending from the domain is refused until it verifies. That is not bureaucracy: mail from an unverified domain damages the sending reputation every customer on the platform shares.

Body

FieldTypeDescription
domainrequiredstringA domain, not an email address.

Example

curl -X POST https://api.woyra.io/v1/domains \
  -H "Authorization: Bearer $WOYRA_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
    "domain": "example.com"
  }'

Response

201 The domain and the DNS it needs.

FieldTypeDescription
object"domain"
idstring
domainstring
statusstring
One of pending, verified, failed.
verified_attimestamp
receivingbooleanTrue once the domain is verified and its MX record points at Woyra: every address on it then receives, and each message is stored under /v1/emails/inbound and sent as email.received.
receiving_verified_attimestamp
created_attimestamp
recordsarray of DNSRecord

Errors

StatusCodes
400invalid_request, unsupported_version
401authentication_required, invalid_api_key
403insufficient_scope, domain_not_verified, recipient_suppressed, sending_paused, mfa_required

Also in Domains