Cakemail API

Form

Endpointhttps://api.cakemail.dev

Create and manage hosted forms for collecting subscriber data. Forms can include reCAPTCHA verification, custom redirect URLs, and double opt-in. Forms are published to generate a public submission URL.

Show all forms

GET

https://api.cakemail.dev

/forms

List all forms in the account.

Required scope(s): forms:read

Show all forms › 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

sort

string · pattern: [-|+]?[a-zA-Z_]+

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

Valid terms:

name
language
created_on
last_updated_on
list_id
status
enabled
updated_on
published_on
branding

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

Valid terms:

name
language
created_on
last_updated_on
list_id
status
enabled
updated_on
published_on
branding

filter

string

Valid Terms:

name

Valid Operators:

==

Query separator:

Valid Terms:

name

Valid Operators:

==

Query separator:

Show all forms › Responses

Successful Response

object · required

array · required

List of forms

GET/forms

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

shell

Example Responses

{
  "pagination": {
    "page": 0,
    "per_page": 0,
    "count": 0
  },
  "data": [
    {
      "id": "id",
      "name": "name",
      "status": "active",
      "content": {
        "linked": "linked",
        "embedded": "embedded"
      },
      "language": "da",
      "created_on": 0,
      "last_updated_on": 0,
      "url": {
        "linked": "linked",
        "embedded": "embedded"
      },
      "thumbnail": "thumbnail",
      "thumbnail_url": "thumbnail_url",
      "redirections": {
        "after_opt_in": "after_opt_in",
        "after_double_opt_in": "after_double_opt_in",
        "after_opt_out": "after_opt_out"
      },
      "list_id": 0,
      "double_opt_in": true
    }
  ]
}

json

application/json

Create a form

POST

https://api.cakemail.dev

/forms

Create a new form. The form must be published before it can accept submissions.

Required scope(s): forms:write

Create a form › query Parameters

account_id

integer · min: 1

Optional Account ID to be used for the request

Create a form › Request Body

anyOf

At least one variant must match. Multiple variants may match simultaneously.

Decision Table

Variant	Matching Criteria
	type = object · requires: name, content, list_id +1 more
	type = object · requires: list_id, name

Properties for CreateForm:

name

string · minLength: 1 · required

Name of the form

object · required

list_id

integer · min: 1 · required

ID of the contact list to subscribe to

language

string · enum · required

Supported Locales

Enum values:

da_DK

de_DE

el_GR

en_US

status

string · enum

An enumeration.

Enum values:

active

deleted

object

double_opt_in

boolean

Whether to use double opt-in

Default: true

type

string

Default: basic

Create a form › Responses

Successful Response

id

string · required

ID of the created form

required

Created form details

object

string

Object type

Default: form

created

boolean

Whether the form was created

Default: true

POST/forms

curl --request POST \
  --url https://api.cakemail.dev/forms \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "name",
  "status": "active",
  "content": {
    "embedded": "embedded",
    "linked": "linked"
  },
  "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"
  },
  "list_id": 0,
  "language": "da",
  "double_opt_in": true,
  "type": "type"
}
'

shell

Example Request Body

{
  "name": "name",
  "status": "active",
  "content": {
    "embedded": "embedded",
    "linked": "linked"
  },
  "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"
  },
  "list_id": 0,
  "language": "da",
  "double_opt_in": true,
  "type": "type"
}

json

Example Responses

{
  "id": "id",
  "object": "object",
  "created": true,
  "data": {
    "id": "id",
    "name": "name",
    "status": "active",
    "content": {
      "linked": "linked",
      "embedded": "embedded"
    },
    "language": "da",
    "created_on": 0,
    "last_updated_on": 0,
    "url": {
      "linked": "linked",
      "embedded": "embedded"
    },
    "thumbnail": "thumbnail",
    "thumbnail_url": "thumbnail_url",
    "redirections": {
      "after_opt_in": "after_opt_in",
      "after_double_opt_in": "after_double_opt_in",
      "after_opt_out": "after_opt_out"
    },
    "list_id": 0,
    "double_opt_in": true
  }
}

json

application/json

Show a form details

GET

https://api.cakemail.dev

/forms/{form_id}

Retrieve the full details of a form, including its configuration, submission URL, and publication status.

Required scope(s): forms:read

Show a form details › path Parameters

form_id

string · required

Show a form details › query Parameters

account_id

integer · min: 1

Optional Account ID to be used for the request

Show a form details › Responses

Successful Response

required

Form details

GET/forms/{form_id}

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

shell

Example Responses

{
  "data": {
    "id": "id",
    "name": "name",
    "status": "active",
    "content": {
      "linked": "linked",
      "embedded": "embedded"
    },
    "language": "da",
    "created_on": 0,
    "last_updated_on": 0,
    "url": {
      "linked": "linked",
      "embedded": "embedded"
    },
    "thumbnail": "thumbnail",
    "thumbnail_url": "thumbnail_url",
    "redirections": {
      "after_opt_in": "after_opt_in",
      "after_double_opt_in": "after_double_opt_in",
      "after_opt_out": "after_opt_out"
    },
    "list_id": 0,
    "double_opt_in": true
  }
}

json

application/json

Delete a form

DELETE

https://api.cakemail.dev

/forms/{form_id}

Delete a form.

Required scope(s): forms:delete

Delete a form › path Parameters

form_id

string · required

Delete a form › query Parameters

account_id

integer · min: 1

Optional Account ID to be used for the request

Delete a form › Responses

Successful Response

id

string · required

ID of the deleted form

object

string

Object type

Default: form

deleted

boolean

Whether the form was deleted

Default: true

DELETE/forms/{form_id}

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

shell

Example Responses

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

json

application/json

Update a form

PATCH

https://api.cakemail.dev

/forms/{form_id}

Update a form's configuration. All fields are optional.

Required scope(s): forms:write

Update a form › path Parameters

form_id

string · required

Update a form › query Parameters

account_id

integer · min: 1

Optional Account ID to be used for the request

Update a form › Request Body

anyOf

At least one variant must match. Multiple variants may match simultaneously.

Decision Table

Variant	Matching Criteria
	type = object
	type = object

Properties for PatchForm:

name

string · minLength: 1

Name of the form

status

string · minLength: 1

Publication status of the form

object

list_id

integer · min: 1

ID of the contact list to subscribe to

language

string · enum

Supported Locales

Enum values:

da_DK

de_DE

el_GR

en_US

double_opt_in

boolean

Whether to use double opt-in

Update a form › Responses

Successful Response

id

string · required

ID of the updated form

required

Updated form details

object

string

Object type

Default: form

updated

boolean

Whether the form was updated

Default: true

PATCH/forms/{form_id}

curl --request PATCH \
  --url https://api.cakemail.dev/forms/:form_id \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "name",
  "status": "status",
  "content": {
    "embedded": "embedded",
    "linked": "linked"
  },
  "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"
  },
  "list_id": 0,
  "language": "da",
  "double_opt_in": true
}
'

shell

Example Request Body

{
  "name": "name",
  "status": "status",
  "content": {
    "embedded": "embedded",
    "linked": "linked"
  },
  "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"
  },
  "list_id": 0,
  "language": "da",
  "double_opt_in": true
}

json

Example Responses

{
  "id": "id",
  "object": "object",
  "updated": true,
  "data": {
    "id": "id",
    "name": "name",
    "status": "active",
    "content": {
      "linked": "linked",
      "embedded": "embedded"
    },
    "language": "da",
    "created_on": 0,
    "last_updated_on": 0,
    "url": {
      "linked": "linked",
      "embedded": "embedded"
    },
    "thumbnail": "thumbnail",
    "thumbnail_url": "thumbnail_url",
    "redirections": {
      "after_opt_in": "after_opt_in",
      "after_double_opt_in": "after_double_opt_in",
      "after_opt_out": "after_opt_out"
    },
    "list_id": 0,
    "double_opt_in": true
  }
}

json

application/json

Publish a form

POST

https://api.cakemail.dev

/forms/{form_id}/publish

Publish a form, generating a public submission URL.

Required scope(s): forms:publish

Publish a form › path Parameters

form_id

string · required

Publish a form › query Parameters

account_id

integer · min: 1

Optional Account ID to be used for the request

Publish a form › Responses

Successful Response

required

Form details

POST/forms/{form_id}/publish

curl --request POST \
  --url https://api.cakemail.dev/forms/:form_id/publish

shell

Example Responses

{
  "data": {
    "id": "id",
    "name": "name",
    "status": "active",
    "content": {
      "linked": "linked",
      "embedded": "embedded"
    },
    "language": "da",
    "created_on": 0,
    "last_updated_on": 0,
    "url": {
      "linked": "linked",
      "embedded": "embedded"
    },
    "thumbnail": "thumbnail",
    "thumbnail_url": "thumbnail_url",
    "redirections": {
      "after_opt_in": "after_opt_in",
      "after_double_opt_in": "after_double_opt_in",
      "after_opt_out": "after_opt_out"
    },
    "list_id": 0,
    "double_opt_in": true
  }
}

json

application/json

Render a form

GET

https://api.cakemail.dev

/forms/{form_id}/render

Render the form's HTML for preview.

Required scope(s): forms:read

Render a form › path Parameters

form_id

string · required

Render a form › query Parameters

published

boolean

Render the published content of the form

Default: false

account_id

integer · min: 1

Optional Account ID to be used for the request

Render a form › Responses

Successful Response

data

string

Rendered HTML content of the form

GET/forms/{form_id}/render

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

shell

Example Responses

{
  "data": "data"
}

json

application/json

Submit a form

POST

https://api.cakemail.dev

/form_submission/{token}

Submit data to a published form. Processes the submission and creates or updates the contact.

Submit a form › path Parameters

token

string · required

Submit a form › Request Body

email

string · email · required

language

string · enum

Supported Locales

Enum values:

da_DK

de_DE

el_GR

en_US

g-recaptcha-response

string

interests

object

tags

object

custom_attributes

object

Submit a form › Responses

Successful Response

status

string · enum · required

An enumeration.

Enum values:

pending

processed

object

string

Object type

Default: form

POST/form_submission/{token}

curl --request POST \
  --url https://api.cakemail.dev/form_submission/:token \
  --header 'Content-Type: application/x-www-form-urlencoded' \
  --data email=test@example.com \
  --data language=da \
  --data g-recaptcha-response=g-recaptcha-response \
  --data 'interests={}' \
  --data 'tags={}' \
  --data 'custom_attributes={}'

shell

Example Request Body

{
  "email": "test@example.com",
  "language": "da",
  "g-recaptcha-response": "g-recaptcha-response",
  "interests": {},
  "tags": {},
  "custom_attributes": {}
}

json

Example Responses

{
  "object": "object",
  "status": "pending"
}

json

application/json

Disable a form

POST

https://api.cakemail.dev

/forms/{form_id}/disable

Disable a form, preventing it from accepting new submissions.

Required scope(s): forms:publish

Disable a form › path Parameters

form_id

string · required

Disable a form › query Parameters

account_id

integer · min: 1

Optional Account ID to be used for the request

Disable a form › Responses

Successful Response

object · required

object

string

Object type

Default: form

enabled

boolean

Whether the form is enabled

Default: false

POST/forms/{form_id}/disable

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

shell

Example Responses

{
  "object": "object",
  "enabled": true,
  "data": {
    "id": "id",
    "list_id": 0,
    "enabled": true,
    "name": "name",
    "post_redirect_url": "post_redirect_url",
    "double_opt_in": true,
    "double_opt_in_redirect_url": "double_opt_in_redirect_url",
    "published_url": "published_url",
    "submission_url": "submission_url",
    "async_processing": true,
    "branding": "smart",
    "created_on": 0,
    "updated_on": 0,
    "published_on": 0,
    "edited_by": {
      "id": 0,
      "email": "email"
    },
    "thumbnail_url": "thumbnail_url",
    "recaptcha": {
      "secret": "secret",
      "domain": "domain",
      "site_key": "site_key"
    },
    "description": "description",
    "tags": [
      "string"
    ],
    "content": {
      "json": {}
    }
  }
}

json

application/json

Enable a form

POST

https://api.cakemail.dev

/forms/{form_id}/enable

Enable a form, allowing it to accept submissions.

Required scope(s): forms:publish

Enable a form › path Parameters

form_id

string · required

Enable a form › query Parameters

account_id

integer · min: 1

Optional Account ID to be used for the request

Enable a form › Responses

Successful Response

object · required

object

string

Object type

Default: form

enabled

boolean

Whether the form is enabled

Default: true

POST/forms/{form_id}/enable

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

shell

Example Responses

{
  "object": "object",
  "enabled": true,
  "data": {
    "id": "id",
    "list_id": 0,
    "enabled": true,
    "name": "name",
    "post_redirect_url": "post_redirect_url",
    "double_opt_in": true,
    "double_opt_in_redirect_url": "double_opt_in_redirect_url",
    "published_url": "published_url",
    "submission_url": "submission_url",
    "async_processing": true,
    "branding": "smart",
    "created_on": 0,
    "updated_on": 0,
    "published_on": 0,
    "edited_by": {
      "id": 0,
      "email": "email"
    },
    "thumbnail_url": "thumbnail_url",
    "recaptcha": {
      "secret": "secret",
      "domain": "domain",
      "site_key": "site_key"
    },
    "description": "description",
    "tags": [
      "string"
    ],
    "content": {
      "json": {}
    }
  }
}

json

application/json

Suppressed Email Webhook

Cakemail API

Form

Endpointhttps://api.cakemail.dev

Show all forms

GET

https://api.cakemail.dev

/forms

List all forms in the account.

Required scope(s): forms:read

Show all forms › 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

sort

string · pattern: [-|+]?[a-zA-Z_]+

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

Valid terms:

name
language
created_on
last_updated_on
list_id
status
enabled
updated_on
published_on
branding

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

Valid terms:

name
language
created_on
last_updated_on
list_id
status
enabled
updated_on
published_on
branding

filter

string

Valid Terms:

name

Valid Operators:

==

Query separator:

Valid Terms:

name

Valid Operators:

==

Query separator:

Show all forms › Responses

Successful Response

object · required

array · required

List of forms

GET/forms

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

shell

Example Responses

{
  "pagination": {
    "page": 0,
    "per_page": 0,
    "count": 0
  },
  "data": [
    {
      "id": "id",
      "name": "name",
      "status": "active",
      "content": {
        "linked": "linked",
        "embedded": "embedded"
      },
      "language": "da",
      "created_on": 0,
      "last_updated_on": 0,
      "url": {
        "linked": "linked",
        "embedded": "embedded"
      },
      "thumbnail": "thumbnail",
      "thumbnail_url": "thumbnail_url",
      "redirections": {
        "after_opt_in": "after_opt_in",
        "after_double_opt_in": "after_double_opt_in",
        "after_opt_out": "after_opt_out"
      },
      "list_id": 0,
      "double_opt_in": true
    }
  ]
}

json

application/json

Create a form

POST

https://api.cakemail.dev

/forms

Create a new form. The form must be published before it can accept submissions.

Required scope(s): forms:write

Create a form › query Parameters

account_id

integer · min: 1

Optional Account ID to be used for the request

Create a form › Request Body

anyOf

At least one variant must match. Multiple variants may match simultaneously.

Decision Table

Variant	Matching Criteria
	type = object · requires: name, content, list_id +1 more
	type = object · requires: list_id, name

Properties for CreateForm:

name

string · minLength: 1 · required

Name of the form

object · required

list_id

integer · min: 1 · required

ID of the contact list to subscribe to

language

string · enum · required

Supported Locales

Enum values:

da_DK

de_DE

el_GR

en_US

status

string · enum

An enumeration.

Enum values:

active

deleted

object

double_opt_in

boolean

Whether to use double opt-in

Default: true

type

string

Default: basic

Create a form › Responses

Successful Response

id

string · required

ID of the created form

required

Created form details

object

string

Object type

Default: form

created

boolean

Whether the form was created

Default: true

POST/forms

curl --request POST \
  --url https://api.cakemail.dev/forms \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "name",
  "status": "active",
  "content": {
    "embedded": "embedded",
    "linked": "linked"
  },
  "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"
  },
  "list_id": 0,
  "language": "da",
  "double_opt_in": true,
  "type": "type"
}
'

shell

Example Request Body

{
  "name": "name",
  "status": "active",
  "content": {
    "embedded": "embedded",
    "linked": "linked"
  },
  "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"
  },
  "list_id": 0,
  "language": "da",
  "double_opt_in": true,
  "type": "type"
}

json

Example Responses

{
  "id": "id",
  "object": "object",
  "created": true,
  "data": {
    "id": "id",
    "name": "name",
    "status": "active",
    "content": {
      "linked": "linked",
      "embedded": "embedded"
    },
    "language": "da",
    "created_on": 0,
    "last_updated_on": 0,
    "url": {
      "linked": "linked",
      "embedded": "embedded"
    },
    "thumbnail": "thumbnail",
    "thumbnail_url": "thumbnail_url",
    "redirections": {
      "after_opt_in": "after_opt_in",
      "after_double_opt_in": "after_double_opt_in",
      "after_opt_out": "after_opt_out"
    },
    "list_id": 0,
    "double_opt_in": true
  }
}

json

application/json

Show a form details

GET

https://api.cakemail.dev

/forms/{form_id}

Retrieve the full details of a form, including its configuration, submission URL, and publication status.

Required scope(s): forms:read

Show a form details › path Parameters

form_id

string · required

Show a form details › query Parameters

account_id

integer · min: 1

Optional Account ID to be used for the request

Show a form details › Responses

Successful Response

required

Form details

GET/forms/{form_id}

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

shell

Example Responses

{
  "data": {
    "id": "id",
    "name": "name",
    "status": "active",
    "content": {
      "linked": "linked",
      "embedded": "embedded"
    },
    "language": "da",
    "created_on": 0,
    "last_updated_on": 0,
    "url": {
      "linked": "linked",
      "embedded": "embedded"
    },
    "thumbnail": "thumbnail",
    "thumbnail_url": "thumbnail_url",
    "redirections": {
      "after_opt_in": "after_opt_in",
      "after_double_opt_in": "after_double_opt_in",
      "after_opt_out": "after_opt_out"
    },
    "list_id": 0,
    "double_opt_in": true
  }
}

json

application/json

Delete a form

DELETE

https://api.cakemail.dev

/forms/{form_id}

Delete a form.

Required scope(s): forms:delete

Delete a form › path Parameters

form_id

string · required

Delete a form › query Parameters

account_id

integer · min: 1

Optional Account ID to be used for the request

Delete a form › Responses

Successful Response

id

string · required

ID of the deleted form

object

string

Object type

Default: form

deleted

boolean

Whether the form was deleted

Default: true

DELETE/forms/{form_id}

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

shell

Example Responses

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

json

application/json

Update a form

PATCH

https://api.cakemail.dev

/forms/{form_id}

Update a form's configuration. All fields are optional.

Required scope(s): forms:write

Update a form › path Parameters

form_id

string · required

Update a form › query Parameters

account_id

integer · min: 1

Optional Account ID to be used for the request

Update a form › Request Body

anyOf

At least one variant must match. Multiple variants may match simultaneously.

Decision Table

Variant	Matching Criteria
	type = object
	type = object

Properties for PatchForm:

name

string · minLength: 1

Name of the form

status

string · minLength: 1

Publication status of the form

object

list_id

integer · min: 1

ID of the contact list to subscribe to

language

string · enum

Supported Locales

Enum values:

da_DK

de_DE

el_GR

en_US

double_opt_in

boolean

Whether to use double opt-in

Update a form › Responses

Successful Response

id

string · required

ID of the updated form

required

Updated form details

object

string

Object type

Default: form

updated

boolean

Whether the form was updated

Default: true

PATCH/forms/{form_id}

curl --request PATCH \
  --url https://api.cakemail.dev/forms/:form_id \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "name",
  "status": "status",
  "content": {
    "embedded": "embedded",
    "linked": "linked"
  },
  "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"
  },
  "list_id": 0,
  "language": "da",
  "double_opt_in": true
}
'

shell

Example Request Body

{
  "name": "name",
  "status": "status",
  "content": {
    "embedded": "embedded",
    "linked": "linked"
  },
  "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"
  },
  "list_id": 0,
  "language": "da",
  "double_opt_in": true
}

json

Example Responses

{
  "id": "id",
  "object": "object",
  "updated": true,
  "data": {
    "id": "id",
    "name": "name",
    "status": "active",
    "content": {
      "linked": "linked",
      "embedded": "embedded"
    },
    "language": "da",
    "created_on": 0,
    "last_updated_on": 0,
    "url": {
      "linked": "linked",
      "embedded": "embedded"
    },
    "thumbnail": "thumbnail",
    "thumbnail_url": "thumbnail_url",
    "redirections": {
      "after_opt_in": "after_opt_in",
      "after_double_opt_in": "after_double_opt_in",
      "after_opt_out": "after_opt_out"
    },
    "list_id": 0,
    "double_opt_in": true
  }
}

json

application/json

Publish a form

POST

https://api.cakemail.dev

/forms/{form_id}/publish

Publish a form, generating a public submission URL.

Required scope(s): forms:publish

Publish a form › path Parameters

form_id

string · required

Publish a form › query Parameters

account_id

integer · min: 1

Optional Account ID to be used for the request

Publish a form › Responses

Successful Response

required

Form details

POST/forms/{form_id}/publish

curl --request POST \
  --url https://api.cakemail.dev/forms/:form_id/publish

shell

Example Responses

{
  "data": {
    "id": "id",
    "name": "name",
    "status": "active",
    "content": {
      "linked": "linked",
      "embedded": "embedded"
    },
    "language": "da",
    "created_on": 0,
    "last_updated_on": 0,
    "url": {
      "linked": "linked",
      "embedded": "embedded"
    },
    "thumbnail": "thumbnail",
    "thumbnail_url": "thumbnail_url",
    "redirections": {
      "after_opt_in": "after_opt_in",
      "after_double_opt_in": "after_double_opt_in",
      "after_opt_out": "after_opt_out"
    },
    "list_id": 0,
    "double_opt_in": true
  }
}

json

application/json

Render a form

GET

https://api.cakemail.dev

/forms/{form_id}/render

Render the form's HTML for preview.

Required scope(s): forms:read

Render a form › path Parameters

form_id

string · required

Render a form › query Parameters

published

boolean

Render the published content of the form

Default: false

account_id

integer · min: 1

Optional Account ID to be used for the request

Render a form › Responses

Successful Response

data

string

Rendered HTML content of the form

GET/forms/{form_id}/render

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

shell

Example Responses

{
  "data": "data"
}

json

application/json

Submit a form

POST

https://api.cakemail.dev

/form_submission/{token}

Submit data to a published form. Processes the submission and creates or updates the contact.

Submit a form › path Parameters

token

string · required

Submit a form › Request Body

email

string · email · required

language

string · enum

Supported Locales

Enum values:

da_DK

de_DE

el_GR

en_US

g-recaptcha-response

string

interests

object

tags

object

custom_attributes

object

Submit a form › Responses

Successful Response

status

string · enum · required

An enumeration.

Enum values:

pending

processed

object

string

Object type

Default: form

POST/form_submission/{token}

curl --request POST \
  --url https://api.cakemail.dev/form_submission/:token \
  --header 'Content-Type: application/x-www-form-urlencoded' \
  --data email=test@example.com \
  --data language=da \
  --data g-recaptcha-response=g-recaptcha-response \
  --data 'interests={}' \
  --data 'tags={}' \
  --data 'custom_attributes={}'

shell

Example Request Body

{
  "email": "test@example.com",
  "language": "da",
  "g-recaptcha-response": "g-recaptcha-response",
  "interests": {},
  "tags": {},
  "custom_attributes": {}
}

json

Example Responses

{
  "object": "object",
  "status": "pending"
}

json

application/json

Disable a form

POST

https://api.cakemail.dev

/forms/{form_id}/disable

Disable a form, preventing it from accepting new submissions.

Required scope(s): forms:publish

Disable a form › path Parameters

form_id

string · required

Disable a form › query Parameters

account_id

integer · min: 1

Optional Account ID to be used for the request

Disable a form › Responses

Successful Response

object · required

object

string

Object type

Default: form

enabled

boolean

Whether the form is enabled

Default: false

POST/forms/{form_id}/disable

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

shell

Example Responses

{
  "object": "object",
  "enabled": true,
  "data": {
    "id": "id",
    "list_id": 0,
    "enabled": true,
    "name": "name",
    "post_redirect_url": "post_redirect_url",
    "double_opt_in": true,
    "double_opt_in_redirect_url": "double_opt_in_redirect_url",
    "published_url": "published_url",
    "submission_url": "submission_url",
    "async_processing": true,
    "branding": "smart",
    "created_on": 0,
    "updated_on": 0,
    "published_on": 0,
    "edited_by": {
      "id": 0,
      "email": "email"
    },
    "thumbnail_url": "thumbnail_url",
    "recaptcha": {
      "secret": "secret",
      "domain": "domain",
      "site_key": "site_key"
    },
    "description": "description",
    "tags": [
      "string"
    ],
    "content": {
      "json": {}
    }
  }
}

json

application/json

Enable a form

POST

https://api.cakemail.dev

/forms/{form_id}/enable

Enable a form, allowing it to accept submissions.

Required scope(s): forms:publish

Enable a form › path Parameters

form_id

string · required

Enable a form › query Parameters

account_id

integer · min: 1

Optional Account ID to be used for the request

Enable a form › Responses

Successful Response

object · required

object

string

Object type

Default: form

enabled

boolean

Whether the form is enabled

Default: true

POST/forms/{form_id}/enable

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

shell

Example Responses

{
  "object": "object",
  "enabled": true,
  "data": {
    "id": "id",
    "list_id": 0,
    "enabled": true,
    "name": "name",
    "post_redirect_url": "post_redirect_url",
    "double_opt_in": true,
    "double_opt_in_redirect_url": "double_opt_in_redirect_url",
    "published_url": "published_url",
    "submission_url": "submission_url",
    "async_processing": true,
    "branding": "smart",
    "created_on": 0,
    "updated_on": 0,
    "published_on": 0,
    "edited_by": {
      "id": 0,
      "email": "email"
    },
    "thumbnail_url": "thumbnail_url",
    "recaptcha": {
      "secret": "secret",
      "domain": "domain",
      "site_key": "site_key"
    },
    "description": "description",
    "tags": [
      "string"
    ],
    "content": {
      "json": {}
    }
  }
}

json

application/json

Suppressed Email Webhook