Skip to main content
POST
/
subaccount
/
domain
shell
curl -X POST "https://api.sendpost.io/api/v1/subaccount/domain" \
-H "accept: application/json" \
-H "X-SubAccount-ApiKey: <subaccount_api_key>" \
-d '{"name": "example.com"}'
{
  "id": 117,
  "name": "piedpiper.com",
  "dkim": {
    "host": "1587987845._domainkey.hooli.com",
    "type": "TXT",
    "textValue": "v=DKIM1;k=rsa;s=email;h=sha256;p=MIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQDsGMUVM1bqebA0bgtf0HQ6P/FZJy42k/OHP0OgVv4WMSsHOvCFre1/6d1GTx3ldeJf612K3L7wV4iJfDMh2FEpuQ+z+pOro3FarWuawoiJbBudgQQ8rResnZ4Sg3W1Zr3tcZgBCEQ9WoLDv/B2dd01p3ZJ40hsco+Fw75Ldnrd3wIDAQAB"
  },
  "returnPath": {
    "host": "sp-bounces.hooli.com",
    "type": "CNAME",
    "textValue": "sp.sendpost.email"
  },
  "track": {
    "host": "track.hooli.com",
    "type": "CNAME",
    "textValue": "api.sendpost.io"
  },
  "dmarc": {
    "host": "_dmarc.hooli.com",
    "type": "TXT",
    "textValue": "v=DMARC1; p=none;"
  },
  "dkimConfig": "<string>",
  "dkimVerified": false,
  "dmarcVerified": false,
  "returnPathVerified": false,
  "trackVerified": true,
  "created": 1567512491587205000
}

Authorizations

X-SubAccount-ApiKey
string
header
required

This api key can be used only for sub account level operations

Body

application/json
name
string

Name of the domain (e.g., hooli.com).

Example:

"hooli.com"

Response

201 - application/json

Successful response

id
integer

Unique ID for the domain.

Example:

117

name
string

Name of the domain.

Example:

"piedpiper.com"

dkim
object

DKIM record host, type and value

returnPath
object

ReturnPath record host, type and value

track
object

Track record host, type and value. This domain will be used for link tracking while rewriting links in your email message

dmarc
object

DMARC record host, type and value

dkimConfig
string

DKIM configuration

dkimVerified
boolean

Status of DKIM verification ( true or false )

Example:

false

dmarcVerified
boolean

Status of DMARC verification ( true or false)

Example:

false

returnPathVerified
boolean

Status of ReturnPath verification ( true or false )

Example:

false

trackVerified
boolean

Status of Track verification ( true or false )

Example:

true

created
integer

UNIX epoch timestamp in nanoseconds.

Example:

1567512491587205000

I