Action

deprecated

List actions

GET

https://api.cakemail.dev

/workflows/{workflow_id}/actions

Required scope(s): automations:read

List actions › path Parameters

workflow_id

string · required

List actions › 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

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

Valid terms:

name
created_on

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

Valid terms:

name
created_on

List actions › Responses

Successful Response

ActionsResponse

Pagination · required

ActionSummaryResponse[] · required

deprecated

Create an action

POST

https://api.cakemail.dev

/workflows/{workflow_id}/actions

Required scope(s): automations:write

Create an action › path Parameters

workflow_id

string · required

Create an action › query Parameters

account_id

integer · min: 1

Optional Account ID to be used for the request

lock_key

string · pattern: ^[a-zA-Z0-9-_]{8,}$

Locking key, preventing other users from modifying this workflow for a short period.

Create an action › Request Body

Action

name

string · required

condition

ActionCondition · enum · required

An enumeration.

Enum values:

opened

not_opened

clicked

not_clicked

none

delay

integer · required

type

ActionType · enum · required

An enumeration.

Enum values:

parent_id

string

ActionEmailSettings

Create an action › Responses

Successful Response

CreateActionResponse

id

string · required

ActionResponse · required

object

string

Default: action

created

boolean

Default: true

POST/workflows/{workflow_id}/actions

curl https://api.cakemail.dev/workflows/:workflow_id/actions \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <token>' \
  --data '{
  "name": "name",
  "parent_id": "parent_id",
  "condition": "opened",
  "delay": 0,
  "type": "email",
  "email_settings": {
    "tracking": {
      "opens": true,
      "clicks_html": true,
      "clicks_text": true
    },
    "content": {
      "subject": "subject",
      "html": "html",
      "text": "text",
      "json": {},
      "type": "html",
      "encoding": "utf-8",
      "template": {
        "id": 0
      }
    },
    "sender": {
      "id": "id"
    }
  }
}'

Example Request Body

{
  "name": "name",
  "parent_id": "parent_id",
  "condition": "opened",
  "delay": 0,
  "type": "email",
  "email_settings": {
    "tracking": {
      "opens": true,
      "clicks_html": true,
      "clicks_text": true
    },
    "content": {
      "subject": "subject",
      "html": "html",
      "text": "text",
      "json": {},
      "type": "html",
      "encoding": "utf-8",
      "template": {
        "id": 0
      }
    },
    "sender": {
      "id": "id"
    }
  }
}

json

Example Responses

{
  "id": "id",
  "object": "action",
  "data": {
    "id": "id",
    "created_on": 0,
    "updated_on": 0,
    "name": "name",
    "parent_id": "parent_id",
    "condition": "opened",
    "delay": 0,
    "type": "email",
    "email_settings": {
      "tracking": {
        "opens": true,
        "clicks_html": true,
        "clicks_text": true
      },
      "content": {
        "subject": "subject",
        "html": "html",
        "text": "text",
        "json": {},
        "type": "html",
        "encoding": "utf-8",
        "template": {
          "id": 0
        }
      },
      "sender": {
        "id": "id"
      }
    },
    "thumbnail_url": "thumbnail_url"
  },
  "created": true
}

json

application/json

deprecated

Get an action

GET

https://api.cakemail.dev

/workflows/{workflow_id}/actions/{action_id}

Required scope(s): automations:read

Get an action › path Parameters

workflow_id

string · required

action_id

string · required

Get an action › query Parameters

account_id

integer · min: 1

Optional Account ID to be used for the request

lock_key

string · pattern: ^[a-zA-Z0-9-_]{8,}$

Locking key, preventing other users from modifying this workflow for a short period.

Get an action › Responses

Successful Response

GetActionResponse

ActionResponse · required

GET/workflows/{workflow_id}/actions/{action_id}

curl https://api.cakemail.dev/workflows/:workflow_id/actions/:action_id \
  --header 'Authorization: Bearer <token>'

Example Responses

{
  "data": {
    "id": "id",
    "created_on": 0,
    "updated_on": 0,
    "name": "name",
    "parent_id": "parent_id",
    "condition": "opened",
    "delay": 0,
    "type": "email",
    "email_settings": {
      "tracking": {
        "opens": true,
        "clicks_html": true,
        "clicks_text": true
      },
      "content": {
        "subject": "subject",
        "html": "html",
        "text": "text",
        "json": {},
        "type": "html",
        "encoding": "utf-8",
        "template": {
          "id": 0
        }
      },
      "sender": {
        "id": "id"
      }
    },
    "thumbnail_url": "thumbnail_url"
  }
}

json

application/json

deprecated

Update an action

PATCH

https://api.cakemail.dev

/workflows/{workflow_id}/actions/{action_id}

Required scope(s): automations:write

Update an action › path Parameters

action_id

string · required

workflow_id

string · required

Update an action › query Parameters

account_id

integer · min: 1

Optional Account ID to be used for the request

lock_key

string · pattern: ^[a-zA-Z0-9-_]{8,}$

Locking key, preventing other users from modifying this workflow for a short period.

Update an action › Request Body

PatchAction

name

string

parent_id

string

condition

ActionCondition · enum

An enumeration.

Enum values:

opened

not_opened

clicked

not_clicked

none

delay

integer

type

ActionType · enum

An enumeration.

Enum values:

PatchActionEmailSettings

Update an action › Responses

Successful Response

PatchActionResponse

id

string · required

ActionResponse · required

object

string

Default: action

patched

boolean

Default: true

PATCH/workflows/{workflow_id}/actions/{action_id}

curl https://api.cakemail.dev/workflows/:workflow_id/actions/:action_id \
  --request PATCH \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <token>' \
  --data '{
  "name": "name",
  "parent_id": "parent_id",
  "condition": "opened",
  "delay": 0,
  "type": "email",
  "email_settings": {
    "tracking": {
      "opens": true,
      "clicks_html": true,
      "clicks_text": true
    },
    "content": {
      "subject": "subject",
      "html": "html",
      "text": "text",
      "json": {},
      "type": "custom",
      "encoding": "utf-8"
    },
    "sender": {
      "id": "id"
    }
  }
}'

Example Request Body

{
  "name": "name",
  "parent_id": "parent_id",
  "condition": "opened",
  "delay": 0,
  "type": "email",
  "email_settings": {
    "tracking": {
      "opens": true,
      "clicks_html": true,
      "clicks_text": true
    },
    "content": {
      "subject": "subject",
      "html": "html",
      "text": "text",
      "json": {},
      "type": "custom",
      "encoding": "utf-8"
    },
    "sender": {
      "id": "id"
    }
  }
}

json

Example Responses

{
  "id": "id",
  "object": "action",
  "patched": true,
  "data": {
    "id": "id",
    "created_on": 0,
    "updated_on": 0,
    "name": "name",
    "parent_id": "parent_id",
    "condition": "opened",
    "delay": 0,
    "type": "email",
    "email_settings": {
      "tracking": {
        "opens": true,
        "clicks_html": true,
        "clicks_text": true
      },
      "content": {
        "subject": "subject",
        "html": "html",
        "text": "text",
        "json": {},
        "type": "html",
        "encoding": "utf-8",
        "template": {
          "id": 0
        }
      },
      "sender": {
        "id": "id"
      }
    },
    "thumbnail_url": "thumbnail_url"
  }
}

json

application/json

deprecated

Delete an action

DELETE

https://api.cakemail.dev

/workflows/{workflow_id}/actions/{action_id}

Required scope(s): automations:delete

Delete an action › path Parameters

action_id

string · required

workflow_id

string · required

Delete an action › query Parameters

account_id

integer · min: 1

Optional Account ID to be used for the request

lock_key

string · pattern: ^[a-zA-Z0-9-_]{8,}$

Locking key, preventing other users from modifying this workflow for a short period.

Delete an action › Responses

Successful Response

DeleteActionResponse

id

string · required

ActionResponse · required

object

string

Default: action

deleted

boolean

Default: true

DELETE/workflows/{workflow_id}/actions/{action_id}

curl https://api.cakemail.dev/workflows/:workflow_id/actions/:action_id \
  --request DELETE \
  --header 'Authorization: Bearer <token>'

Example Responses

{
  "id": "id",
  "object": "action",
  "deleted": true,
  "data": {
    "id": "id",
    "created_on": 0,
    "updated_on": 0,
    "name": "name",
    "parent_id": "parent_id",
    "condition": "opened",
    "delay": 0,
    "type": "email",
    "email_settings": {
      "tracking": {
        "opens": true,
        "clicks_html": true,
        "clicks_text": true
      },
      "content": {
        "subject": "subject",
        "html": "html",
        "text": "text",
        "json": {},
        "type": "html",
        "encoding": "utf-8",
        "template": {
          "id": 0
        }
      },
      "sender": {
        "id": "id"
      }
    },
    "thumbnail_url": "thumbnail_url"
  }
}

json

application/json

deprecated

Render an action

GET

https://api.cakemail.dev

/workflows/{workflow_id}/actions/{action_id}/render

Required scope(s): automations:read

Render an action › path Parameters

workflow_id

string · required

action_id

string · required

Render an action › query Parameters

contact_id

integer · min: 1

account_id

integer · min: 1

lock_key

string · pattern: ^[a-zA-Z0-9-_]{8,}$

Locking key, preventing other users from modifying this workflow for a short period.

Render an action › Responses

Successful Response

string

deprecated

Send a test of an action

POST

https://api.cakemail.dev

/workflows/{workflow_id}/actions/{action_id}/send-test

Required scope(s): automations:write

Send a test of an action › path Parameters

workflow_id

string · required

action_id

string · required

Send a test of an action › query Parameters

account_id

integer · min: 1

Optional Account ID to be used for the request

lock_key

string · pattern: ^[a-zA-Z0-9-_]{8,}$

Locking key, preventing other users from modifying this workflow for a short period.

Send a test of an action › Request Body

SendTestAction

email

string · email · required

type

string · enum

An enumeration.

Enum values:

merged

separated

Default: merged

Send a test of an action › Responses

Successful Response

SendTestActionResponse

id

string · required

object

string

Default: action

sent

boolean

Default: true

deprecated

Show action links

GET

https://api.cakemail.dev

/workflows/{workflow_id}/actions/{action_id}/links

Show action links › path Parameters

action_id

string · required

workflow_id

string · required

Show action links › 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

Show action links › Responses

Successful Response

LinksResponse

object · required

Pagination metadata

LinkFullResponse[] · required

List of links

Sub-Account Workflow