Register new domain

Shell

curl https://api.acymailer.com/api/createDomainIdentity \
 -X POST
 -H 'Content-Type: application/json' \
 -H 'API-KEY: your-license-key' \
 -H 'Version: external' \
 -d '{"domain": "example.com","siteUrl": "https://example.com"}'

PHP

Node

POST /api/createDomainIdentity

This endpoint allows you to register a new domain identity to send email with

Headers

Name	Value
Content-Type	application/json
API-KEY	<license-key>
Version	Must be "external"

Body

{
    "domain": "example.com",
    "siteUrl": "https://example.com"
}

• domain must be your root domain, if you register a subdomain it won't work.

• siteUrl must be https://<your-domain>, even if you don't have a website at this address

Response

200: Already Exist

{
  "code": 9,
  "message": "Identity created",
  "cnameRecords": [
    {
      "name": "2qsv5cnrrzscxcz2otmdlgnkxu3f7wpv._domainkey.example.com",
      "type": "CNAME",
      "value": "2qsv5cnrrzscxcz2otmdlgnkxu3f7wpv.dkim.acymailer.com"
    },
    {
      "name": "4rngy5xnrec3qmwotcr6p7whqi7ig46z._domainkey.example.com",
      "type": "CNAME",
      "value": "4rngy5xnrec3qmwotcr6p7whqi7ig46z.dkim.acymailer.com"
    },
    {
      "name": "tokt23mkvo5cqtgk3vgpmdy6toscp4uh._domainkey.example.com",
      "type": "CNAME",
      "value": "tokt23mkvo5cqtgk3vgpmdy6toscp4uh.dkim.acymailer.com"
    }
  ]
}

201: Created

404

400

403

403

422