Cakemail API

Domain

Endpointhttps://api.cakemail.dev

Configure custom tracking and bounce domains. Custom domains replace default platform URLs in email links and bounce handling with your own branded domains.

Show domains

GET

https://api.cakemail.dev

/brands/default/domains/default

Show the Tracking and Bounce domains.

Required scope(s): domains:read

Show domains › query Parameters

account_id

integer · min: 1

Optional Account ID to be used for the request

Show domains › Responses

Successful Response

object · required

GET/brands/default/domains/default

curl --request GET \
  --url https://api.cakemail.dev/brands/default/domains/default

shell

Example Responses

{
  "data": {
    "auth": "auth",
    "bounce": "bounce",
    "dkim": "dkim",
    "tracking": "tracking"
  }
}

json

application/json

Change domains

PATCH

https://api.cakemail.dev

/brands/default/domains/default

Change the Tracking and Bounce domains.

Required scope(s): domains:write

Change domains › query Parameters

account_id

integer · min: 1

Optional Account ID to be used for the request

Change domains › Request Body

object · required

Change domains › Responses

Successful Response

object · required

object

string

Default: domains

patched

boolean

Default: true

PATCH/brands/default/domains/default

curl --request PATCH \
  --url https://api.cakemail.dev/brands/default/domains/default \
  --header 'Content-Type: application/json' \
  --data '
{
  "domains": {
    "bounce": "bounce",
    "tracking": "https://www.example.com/path/to/resource",
    "forward": "https://www.example.com/path/to/resource"
  }
}
'

shell

Example Request Body

{
  "domains": {
    "bounce": "bounce",
    "tracking": "https://www.example.com/path/to/resource",
    "forward": "https://www.example.com/path/to/resource"
  }
}

json

Example Responses

{
  "object": "object",
  "patched": true,
  "data": {
    "auth": "auth",
    "bounce": "bounce",
    "dkim": "dkim",
    "tracking": "tracking"
  }
}

json

application/json

Validate domains

GET

https://api.cakemail.dev

/brands/default/domains/default/validate

Validate and return the DNS entries for the Tracking and the Bounce domains.

Required scope(s): domains:read

Validate domains › query Parameters

account_id

integer · min: 1

Optional Account ID to be used for the request

Validate domains › Responses

Successful Response

object · required

GET/brands/default/domains/default/validate

curl --request GET \
  --url https://api.cakemail.dev/brands/default/domains/default/validate

shell

Example Responses

{
  "data": {
    "bounce": [
      {
        "entry": "entry",
        "valid": true
      }
    ],
    "tracking": [
      {
        "entry": "entry",
        "valid": true
      }
    ]
  }
}

json

application/json

DKIM Suppressed Email

Show domains

GET

https://api.cakemail.dev

/brands/default/domains/default

Show the Tracking and Bounce domains.

Required scope(s): domains:read

Show domains › query Parameters

account_id

integer · min: 1

Optional Account ID to be used for the request

Show domains › Responses

Successful Response

object · required

Change domains

PATCH

https://api.cakemail.dev

/brands/default/domains/default

Change the Tracking and Bounce domains.

Required scope(s): domains:write

Change domains › query Parameters

account_id

integer · min: 1

Optional Account ID to be used for the request

Change domains › Request Body

object · required

Change domains › Responses

Successful Response

object · required

object

string

Default: domains

patched

boolean

Default: true

Validate domains

GET

https://api.cakemail.dev

/brands/default/domains/default/validate

Validate and return the DNS entries for the Tracking and the Bounce domains.

Required scope(s): domains:read

Validate domains › query Parameters

account_id

integer · min: 1

Optional Account ID to be used for the request

Validate domains › Responses

Successful Response

object · required