Cakemail API

List

Endpointhttps://api.cakemail.dev

Manage contact lists. A list is a collection of contacts (email subscribers) with its own sender identity, language, and subscription settings. Lists support double opt-in, custom redirect URLs after subscription events, and webhook notifications. Also includes deprecated subscription form endpoints for legacy integrations — use the Form endpoints instead.

Show all lists

GET

https://api.cakemail.dev

/lists

List all contact lists in the account. Results can be filtered by name and status, and sorted by name or creation date.

Required scope(s): lists:read

Show all lists › query Parameters

account_id

integer · min: 1

Optional Account ID to be used for the request

page

integer · min: 1

Default: 1

per_page

integer · min: 1

Default: 50

with_count

boolean

Include count in the response

Default: false

filter

string

Valid Terms:

status
name

Valid Operators:

==

Query separator:

Valid Terms:

status
name

Valid Operators:

==

Query separator:

sort

string

Sort term and direction, using syntax [-|+]term.

Valid terms:

name
created_on

Sort term and direction, using syntax [-|+]term.

Valid terms:

name
created_on

Show all lists › Responses

Successful Response

object · required

object[] · required

GET/lists

curl --request GET \
  --url https://api.cakemail.dev/lists

shell

Example Responses

{
  "pagination": {
    "page": 0,
    "per_page": 0,
    "count": 0
  },
  "data": [
    {
      "id": 0,
      "name": "name",
      "status": "status",
      "language": "language",
      "created_on": 0,
      "default_sender": {
        "name": "name",
        "email": "email"
      }
    }
  ]
}

json

application/json

Create a List

POST

https://api.cakemail.dev

/lists

Create a new contact list. A default sender must be specified — this is the sender identity used for campaigns sent to this list. Lists are created with double opt-in enabled by default.

Required scope(s): lists:write

Create a List › query Parameters

account_id

integer · min: 1

Optional Account ID to be used for the request

Create a List › Request Body

name

string · minLength: 1 · required

List Name

object · required

language

string · enum

Supported Locales

Enum values:

da_DK

de_DE

el_GR

en_US

object

Create a List › Responses

Successful Response

id

integer · required

object · required

created

boolean

Default: true

POST/lists

curl --request POST \
  --url https://api.cakemail.dev/lists \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "name",
  "default_sender": {
    "id": "id"
  },
  "language": "da",
  "redirections": {
    "after_opt_in": "https://www.example.com/path/to/resource",
    "after_double_opt_in": "https://www.example.com/path/to/resource",
    "after_opt_out": "https://www.example.com/path/to/resource"
  },
  "webhook": {
    "url": "https://www.example.com/path/to/resource",
    "actions": [
      "all"
    ]
  }
}
'

shell

Example Request Body

{
  "name": "name",
  "default_sender": {
    "id": "id"
  },
  "language": "da",
  "redirections": {
    "after_opt_in": "https://www.example.com/path/to/resource",
    "after_double_opt_in": "https://www.example.com/path/to/resource",
    "after_opt_out": "https://www.example.com/path/to/resource"
  },
  "webhook": {
    "url": "https://www.example.com/path/to/resource",
    "actions": [
      "all"
    ]
  }
}

json

Example Responses

{
  "id": 0,
  "created": true,
  "data": {
    "id": 0,
    "name": "name",
    "status": "status",
    "policy_accepted": true,
    "language": "language",
    "created_on": 0,
    "default_sender": {
      "name": "name",
      "email": "email"
    },
    "redirections": {
      "after_opt_in": "after_opt_in",
      "after_double_opt_in": "after_double_opt_in",
      "after_opt_out": "after_opt_out"
    },
    "pages": {
      "opt_in": "opt_in",
      "opt_out": "opt_out",
      "subscribe": "subscribe",
      "unsubscribe": "unsubscribe"
    },
    "webhook": {
      "url": "url",
      "actions": [
        "all"
      ]
    }
  }
}

json

application/json

Show a list parameters

GET

https://api.cakemail.dev

/lists/{list_id}

Retrieve the full details of a list, including its name, language, default sender, redirect URLs, webhook configuration, and pages.

Required scope(s): lists:read

Show a list parameters › path Parameters

list_id

integer · min: 1 · required

Show a list parameters › query Parameters

account_id

integer · min: 1

Optional Account ID to be used for the request

Show a list parameters › Responses

Successful Response

object · required

GET/lists/{list_id}

curl --request GET \
  --url https://api.cakemail.dev/lists/:list_id

shell

Example Responses

{
  "data": {
    "id": 0,
    "name": "name",
    "status": "status",
    "policy_accepted": true,
    "language": "language",
    "created_on": 0,
    "default_sender": {
      "name": "name",
      "email": "email"
    },
    "redirections": {
      "after_opt_in": "after_opt_in",
      "after_double_opt_in": "after_double_opt_in",
      "after_opt_out": "after_opt_out"
    },
    "pages": {
      "opt_in": "opt_in",
      "opt_out": "opt_out",
      "subscribe": "subscribe",
      "unsubscribe": "unsubscribe"
    },
    "webhook": {
      "url": "url",
      "actions": [
        "all"
      ]
    }
  }
}

json

application/json

Delete a List

DELETE

https://api.cakemail.dev

/lists/{list_id}

Permanently delete a list and all its contacts. This action cannot be undone. To preserve the data, archive the list instead.

Required scope(s): lists:delete

Delete a List › path Parameters

list_id

integer · min: 1 · required

Delete a List › query Parameters

account_id

integer · min: 1

Optional Account ID to be used for the request

Delete a List › Responses

Successful Response

id

integer · required

object

string

Default: list

deleted

boolean

Default: true

DELETE/lists/{list_id}

curl --request DELETE \
  --url https://api.cakemail.dev/lists/:list_id

shell

Example Responses

{
  "id": 0,
  "object": "object",
  "deleted": true
}

json

application/json

Update a list parameters

PATCH

https://api.cakemail.dev

/lists/{list_id}

Update a list's settings. All fields are optional — only provided fields are updated. Can change the name, default sender, language, redirect URLs, and webhook configuration.

Required scope(s): lists:write

Update a list parameters › path Parameters

list_id

integer · min: 1 · required

Update a list parameters › query Parameters

account_id

integer · min: 1

Optional Account ID to be used for the request

Update a list parameters › Request Body

name

string · minLength: 1

object

language

string · enum

Supported Locales

Enum values:

da_DK

de_DE

el_GR

en_US

object

Update a list parameters › Responses

Successful Response

id

integer · required

object · required

updated

boolean

Default: true

PATCH/lists/{list_id}

curl --request PATCH \
  --url https://api.cakemail.dev/lists/:list_id \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "name",
  "default_sender": {
    "id": "id"
  },
  "language": "da",
  "redirections": {
    "after_opt_in": "https://www.example.com/path/to/resource",
    "after_double_opt_in": "https://www.example.com/path/to/resource",
    "after_opt_out": "https://www.example.com/path/to/resource"
  },
  "webhook": {
    "url": "https://www.example.com/path/to/resource",
    "actions": [
      "all"
    ]
  }
}
'

shell

Example Request Body

{
  "name": "name",
  "default_sender": {
    "id": "id"
  },
  "language": "da",
  "redirections": {
    "after_opt_in": "https://www.example.com/path/to/resource",
    "after_double_opt_in": "https://www.example.com/path/to/resource",
    "after_opt_out": "https://www.example.com/path/to/resource"
  },
  "webhook": {
    "url": "https://www.example.com/path/to/resource",
    "actions": [
      "all"
    ]
  }
}

json

Example Responses

{
  "id": 0,
  "updated": true,
  "data": {
    "id": 0,
    "name": "name",
    "status": "status",
    "policy_accepted": true,
    "language": "language",
    "created_on": 0,
    "default_sender": {
      "name": "name",
      "email": "email"
    },
    "redirections": {
      "after_opt_in": "after_opt_in",
      "after_double_opt_in": "after_double_opt_in",
      "after_opt_out": "after_opt_out"
    },
    "pages": {
      "opt_in": "opt_in",
      "opt_out": "opt_out",
      "subscribe": "subscribe",
      "unsubscribe": "unsubscribe"
    },
    "webhook": {
      "url": "url",
      "actions": [
        "all"
      ]
    }
  }
}

json

application/json

Accept policy for a list

POST

https://api.cakemail.dev

/lists/{list_id}/accept-policy

Accept the anti-spam policy for a list. This acknowledgement is required before the list can be used for sending campaigns.

Required scope(s): lists:write

Accept policy for a list › path Parameters

list_id

integer · min: 1 · required

Accept policy for a list › query Parameters

account_id

integer · min: 1

Optional Account ID to be used for the request

Accept policy for a list › Responses

Successful Response

id

integer · required

object

string

Default: list

policy_accepted

boolean

Default: true

POST/lists/{list_id}/accept-policy

curl --request POST \
  --url https://api.cakemail.dev/lists/:list_id/accept-policy

shell

Example Responses

{
  "id": 0,
  "object": "object",
  "policy_accepted": true
}

json

application/json

Archive a list

POST

https://api.cakemail.dev

/lists/{list_id}/archive

Archive a list, making it inactive. Archived lists retain their contacts and data but cannot be used for sending campaigns.

Required scope(s): lists:write

Archive a list › path Parameters

list_id

integer · min: 1 · required

Archive a list › query Parameters

account_id

integer · min: 1

Optional Account ID to be used for the request

Archive a list › Responses

Successful Response

id

integer · required

object

string

Default: list

archived

boolean

Default: true

POST/lists/{list_id}/archive

curl --request POST \
  --url https://api.cakemail.dev/lists/:list_id/archive

shell

Example Responses

{
  "id": 0,
  "object": "object",
  "archived": true
}

json

application/json

deprecated

Enable a subscription form endpoint

POST

https://api.cakemail.dev

/lists/{list_id}/forms/{form_id}/enable

Required scope(s): lists:write

Enable a subscription form endpoint › path Parameters

form_id

string · minLength: 1 · pattern: ^[a-zA-Z0-9]+$ · required

list_id

integer · min: 1 · required

Enable a subscription form endpoint › query Parameters

account_id

integer · min: 1

Optional Account ID to be used for the request

Enable a subscription form endpoint › Responses

Successful Response

object · required

object

string

Default: subscription_form_endpoint

enabled

boolean

Default: true

POST/lists/{list_id}/forms/{form_id}/enable

curl --request POST \
  --url https://api.cakemail.dev/lists/:list_id/forms/:form_id/enable

shell

Example Responses

{
  "object": "object",
  "enabled": true,
  "data": {
    "id": "id",
    "enabled": true,
    "name": "name",
    "domain": "domain",
    "secret": "secret",
    "post_redirect_url": "post_redirect_url",
    "double_opt_in": true,
    "double_opt_in_redirect_url": "double_opt_in_redirect_url",
    "submission_url": "submission_url",
    "async_processing": true
  }
}

json

application/json

deprecated

Disable a subscription form endpoint

POST

https://api.cakemail.dev

/lists/{list_id}/forms/{form_id}/disable

Required scope(s): lists:write

Disable a subscription form endpoint › path Parameters

form_id

string · minLength: 1 · pattern: ^[a-zA-Z0-9]+$ · required

list_id

integer · min: 1 · required

Disable a subscription form endpoint › query Parameters

account_id

integer · min: 1

Optional Account ID to be used for the request

Disable a subscription form endpoint › Responses

Successful Response

object · required

object

string

Default: subscription_form_endpoint

enabled

boolean

Default: false

POST/lists/{list_id}/forms/{form_id}/disable

curl --request POST \
  --url https://api.cakemail.dev/lists/:list_id/forms/:form_id/disable

shell

Example Responses

{
  "object": "object",
  "enabled": true,
  "data": {
    "id": "id",
    "enabled": true,
    "name": "name",
    "domain": "domain",
    "secret": "secret",
    "post_redirect_url": "post_redirect_url",
    "double_opt_in": true,
    "double_opt_in_redirect_url": "double_opt_in_redirect_url",
    "submission_url": "submission_url",
    "async_processing": true
  }
}

json

application/json

deprecated

List subscription form endpoints

GET

https://api.cakemail.dev

/lists/{list_id}/forms

Required scope(s): lists:read

List subscription form endpoints › path Parameters

list_id

integer · min: 1 · required

List subscription form endpoints › query Parameters

account_id

integer · min: 1

Optional Account ID to be used for the request

page

integer · min: 1

Default: 1

per_page

integer · min: 1

Default: 50

with_count

boolean

Include count in the response

Default: false

List subscription form endpoints › Responses

Successful Response

object · required

object[] · required

GET/lists/{list_id}/forms

curl --request GET \
  --url https://api.cakemail.dev/lists/:list_id/forms

shell

Example Responses

{
  "pagination": {
    "page": 0,
    "per_page": 0,
    "count": 0
  },
  "data": [
    {
      "id": "id",
      "enabled": true,
      "name": "name",
      "domain": "domain",
      "secret": "secret",
      "post_redirect_url": "post_redirect_url",
      "double_opt_in": true,
      "double_opt_in_redirect_url": "double_opt_in_redirect_url",
      "submission_url": "submission_url",
      "async_processing": true
    }
  ]
}

json

application/json

deprecated

Create a subscription form endpoint

POST

https://api.cakemail.dev

/lists/{list_id}/forms

Required scope(s): lists:write

Create a subscription form endpoint › path Parameters

list_id

integer · min: 1 · required

Create a subscription form endpoint › query Parameters

account_id

integer · min: 1

Optional Account ID to be used for the request

Create a subscription form endpoint › Request Body

domain

string · pattern: ^(?:[a-zA-Z0-9](?:[a…

domain name hosting the form

name

string

Name of the form

double_opt_in

boolean

Whether to use double opt in

Default: true

secret

string

Google reCaptcha secret key

post_redirect_url

string

Instead of the usual API reply, redirect to this URL when submitting the form.

double_opt_in_redirect_url

string

Redirect to this URL after the double opt in callback.

async_processing

boolean

Whether to process the form submission asynchronously.

Default: true

Create a subscription form endpoint › Responses

Successful Response

object · required

object

string

Default: subscription_form_endpoint

created

boolean

Default: true

POST/lists/{list_id}/forms

curl --request POST \
  --url https://api.cakemail.dev/lists/:list_id/forms \
  --header 'Content-Type: application/json' \
  --data '
{
  "domain": "domain",
  "name": "name",
  "double_opt_in": true,
  "secret": "secret",
  "post_redirect_url": "post_redirect_url",
  "double_opt_in_redirect_url": "double_opt_in_redirect_url",
  "async_processing": true
}
'

shell

Example Request Body

{
  "domain": "domain",
  "name": "name",
  "double_opt_in": true,
  "secret": "secret",
  "post_redirect_url": "post_redirect_url",
  "double_opt_in_redirect_url": "double_opt_in_redirect_url",
  "async_processing": true
}

json

Example Responses

{
  "object": "object",
  "created": true,
  "data": {
    "id": "id",
    "enabled": true,
    "name": "name",
    "domain": "domain",
    "secret": "secret",
    "post_redirect_url": "post_redirect_url",
    "double_opt_in": true,
    "double_opt_in_redirect_url": "double_opt_in_redirect_url",
    "submission_url": "submission_url",
    "async_processing": true
  }
}

json

application/json

deprecated

Show a subscription form endpoint

GET

https://api.cakemail.dev

/lists/{list_id}/forms/{form_id}

Required scope(s): lists:read

Show a subscription form endpoint › path Parameters

form_id

string · minLength: 1 · pattern: ^[a-zA-Z0-9]+$ · required

list_id

integer · min: 1 · required

Show a subscription form endpoint › query Parameters

account_id

integer · min: 1

Optional Account ID to be used for the request

Show a subscription form endpoint › Responses

Successful Response

object · required

GET/lists/{list_id}/forms/{form_id}

curl --request GET \
  --url https://api.cakemail.dev/lists/:list_id/forms/:form_id

shell

Example Responses

{
  "data": {
    "id": "id",
    "enabled": true,
    "name": "name",
    "domain": "domain",
    "secret": "secret",
    "post_redirect_url": "post_redirect_url",
    "double_opt_in": true,
    "double_opt_in_redirect_url": "double_opt_in_redirect_url",
    "submission_url": "submission_url",
    "async_processing": true
  }
}

json

application/json

deprecated

Delete a subscription form endpoint

DELETE

https://api.cakemail.dev

/lists/{list_id}/forms/{form_id}

Required scope(s): lists:delete

Delete a subscription form endpoint › path Parameters

form_id

string · minLength: 1 · pattern: ^[a-zA-Z0-9]+$ · required

list_id

integer · min: 1 · required

Delete a subscription form endpoint › query Parameters

account_id

integer · min: 1

Optional Account ID to be used for the request

Delete a subscription form endpoint › Responses

Successful Response

object · required

object

string

Default: subscription_form_endpoint

deleted

boolean

Default: true

DELETE/lists/{list_id}/forms/{form_id}

curl --request DELETE \
  --url https://api.cakemail.dev/lists/:list_id/forms/:form_id

shell

Example Responses

{
  "object": "object",
  "deleted": true,
  "data": {
    "id": "id",
    "enabled": true,
    "name": "name",
    "domain": "domain",
    "secret": "secret",
    "post_redirect_url": "post_redirect_url",
    "double_opt_in": true,
    "double_opt_in_redirect_url": "double_opt_in_redirect_url",
    "submission_url": "submission_url",
    "async_processing": true
  }
}

json

application/json

deprecated

Patch a subscription form endpoint

PATCH

https://api.cakemail.dev

/lists/{list_id}/forms/{form_id}

Required scope(s): lists:write

Patch a subscription form endpoint › path Parameters

form_id

string · minLength: 1 · pattern: ^[a-zA-Z0-9]+$ · required

list_id

integer · min: 1 · required

Patch a subscription form endpoint › query Parameters

account_id

integer · min: 1

Optional Account ID to be used for the request

Patch a subscription form endpoint › Request Body

domain

string · pattern: ^(?:[a-zA-Z0-9](?:[a…

domain name hosting the form

name

string

Name of the form

double_opt_in

boolean

Whether to use double opt in

secret

string

Google reCaptcha secret key

post_redirect_url

string

Instead of the usual API reply, redirect to this URL when submitting the form.

double_opt_in_redirect_url

string

Redirect to this URL after the double opt in callback.

async_processing

boolean

Whether to process the form submission asynchronously.

Patch a subscription form endpoint › Responses

Successful Response

object · required

object

string

Default: subscription_form_endpoint

updated

boolean

Default: true

PATCH/lists/{list_id}/forms/{form_id}

curl --request PATCH \
  --url https://api.cakemail.dev/lists/:list_id/forms/:form_id \
  --header 'Content-Type: application/json' \
  --data '
{
  "domain": "domain",
  "name": "name",
  "double_opt_in": true,
  "secret": "secret",
  "post_redirect_url": "post_redirect_url",
  "double_opt_in_redirect_url": "double_opt_in_redirect_url",
  "async_processing": true
}
'

shell

Example Request Body

{
  "domain": "domain",
  "name": "name",
  "double_opt_in": true,
  "secret": "secret",
  "post_redirect_url": "post_redirect_url",
  "double_opt_in_redirect_url": "double_opt_in_redirect_url",
  "async_processing": true
}

json

Example Responses

{
  "object": "object",
  "updated": true,
  "data": {
    "id": "id",
    "enabled": true,
    "name": "name",
    "domain": "domain",
    "secret": "secret",
    "post_redirect_url": "post_redirect_url",
    "double_opt_in": true,
    "double_opt_in_redirect_url": "double_opt_in_redirect_url",
    "submission_url": "submission_url",
    "async_processing": true
  }
}

json

application/json

User Contact