Skip to main content
API docs by Redocly

API V1 (v1)

Download OpenAPI specification:Download

Organizations

Update Organization

Updates an organization.

Authorizations:
CookieAuthBearerAuth
path Parameters
id
required
integer

Organization ID

Request Body schema: application/json
name
string
email
string
country
string

Responses

Request samples

Content type
application/json
{}

Response samples

Content type
application/json
{
  • "id": 12345,
  • "name": "My Organization",
  • "created_at": "2023-08-23T10:30:00.000Z",
  • "updated_at": "2023-08-23T10:30:00.000Z",
  • "free_trial_ends_at": "2023-08-23T10:30:00.000Z",
  • "email": "[email protected]",
  • "country": "US",
  • "subscription_details": {
    },
  • "features": {
    }
}

Projects

List Projects

Retrieves the projects the user has access to.

Authorizations:
CookieAuthBearerAuth
query Parameters
per
integer
Default: 10

Number of records per page

page
integer
Default: 1

Page number

search
string

Filter projects by name

Responses

Response samples

Content type
application/json
{
  • "results": [
    ],
  • "pagination": {
    }
}

Creates a project.

Creates a new project.

Authorizations:
CookieAuthBearerAuth
Request Body schema: application/json
name
required
string

Project name

description
string or null

Project description

Responses

Request samples

Content type
application/json
{
  • "name": "Black Friday 2020",
  • "description": "All emails related to Black Friday 2020."
}

Response samples

Content type
application/json
{
  • "id": 12345,
  • "name": "Black Friday 2023",
  • "created_at": "2023-08-23T10:30:00.000Z",
  • "updated_at": "2023-08-23T10:30:00.000Z",
  • "description": "Black Friday 2023 Marketing Campaign",
  • "organization_id": 12345
}

Get Project

Retrieves a single project by ID.

Authorizations:
CookieAuthBearerAuth
path Parameters
id
required
integer

Project ID

Responses

Response samples

Content type
application/json
{
  • "id": 12345,
  • "name": "Black Friday 2023",
  • "created_at": "2023-08-23T10:30:00.000Z",
  • "updated_at": "2023-08-23T10:30:00.000Z",
  • "description": "Black Friday 2023 Marketing Campaign",
  • "organization_id": 12345
}

Update Project

Updates a project.

Authorizations:
CookieAuthBearerAuth
path Parameters
id
required
integer

Project ID

Request Body schema: application/json
name
required
string

Project name

description
string or null

Project description

Responses

Request samples

Content type
application/json
{
  • "name": "Black Friday 2020",
  • "description": "All emails related to Black Friday 2020."
}

Response samples

Content type
application/json
{
  • "id": 12345,
  • "name": "Black Friday 2023",
  • "created_at": "2023-08-23T10:30:00.000Z",
  • "updated_at": "2023-08-23T10:30:00.000Z",
  • "description": "Black Friday 2023 Marketing Campaign",
  • "organization_id": 12345
}

Delete Project

Deletes a project.

Authorizations:
CookieAuthBearerAuth
path Parameters
id
required
integer

Project ID

Responses

Project Users

List Project Users

Retrieves the users for a project.

Authorizations:
CookieAuthBearerAuth
path Parameters
id
required
integer

Project ID

Responses

Response samples

Content type
application/json
{
  • "results": [
    ],
  • "pagination": {
    }
}

Update Project Users

Updates the users for a project.

Authorizations:
CookieAuthBearerAuth
path Parameters
id
required
integer

Project ID

Request Body schema: application/json
user_ids
required
Array of integers

Responses

Request samples

Content type
application/json
{
  • "user_ids": [
    ]
}

Response samples

Content type
application/json
{
  • "results": [
    ],
  • "pagination": {
    }
}

Emails

List Emails

Retrieves the Emails the user has access to.

Authorizations:
CookieAuthBearerAuth
query Parameters
per
integer
Default: 10

Number of records per page

page
integer
Default: 1

Page number

project_id
integer

Filter emails by project ID

Responses

Response samples

Content type
application/json
{
  • "results": [
    ],
  • "pagination": {
    }
}

Create Email

Creates a new Email.

Authorizations:
CookieAuthBearerAuth
Request Body schema: application/json
name
required
string
email_design_system_id
required
integer
default_locale
string (Locale)
Enum: "ar-SA" "bn-BD" "bn-IN" "cs-CZ" "da-DK" "de-AT" "de-CH" "de-DE" "el-GR" "en-AU" "en-CA" "en-GB" "en-IE" "en-IN" "en-NZ" "en-US" "en-ZA" "es-AR" "es-CL" "es-CO" "es-ES" "es-MX" "es-US" "fi-FI" "fr-BE" "fr-CA" "fr-CH" "fr-FR" "he-IL" "hi-IN" "hu-HU" "id-ID" "it-CH" "it-IT" "ja-JP" "ko-KR" "nl-BE" "nl-NL" "no-NO" "pl-PL" "pt-BR" "pt-PT" "ro-RO" "ru-RU" "sk-SK" "sv-SE" "ta-IN" "ta-LK" "th-TH" "tr-TR" "zh-CN" "zh-HK"
locales
Array of strings (Locale)
Items Enum: "ar-SA" "bn-BD" "bn-IN" "cs-CZ" "da-DK" "de-AT" "de-CH" "de-DE" "el-GR" "en-AU" "en-CA" "en-GB" "en-IE" "en-IN" "en-NZ" "en-US" "en-ZA" "es-AR" "es-CL" "es-CO" "es-ES" "es-MX" "es-US" "fi-FI" "fr-BE" "fr-CA" "fr-CH" "fr-FR" "he-IL" "hi-IN" "hu-HU" "id-ID" "it-CH" "it-IT" "ja-JP" "ko-KR" "nl-BE" "nl-NL" "no-NO" "pl-PL" "pt-BR" "pt-PT" "ro-RO" "ru-RU" "sk-SK" "sv-SE" "ta-IN" "ta-LK" "th-TH" "tr-TR" "zh-CN" "zh-HK"
project_id
required
integer
create_with_ai
boolean
ai_agent_id
integer
prompt
string

Responses

Request samples

Content type
application/json
{
  • "name": "string",
  • "email_design_system_id": 0,
  • "default_locale": "en-US",
  • "locales": [
    ],
  • "project_id": 0,
  • "create_with_ai": true,
  • "ai_agent_id": 0,
  • "prompt": "string"
}

Response samples

Content type
application/json
{
  • "id": 12345,
  • "name": "My Email",
  • "project_id": 12345,
  • "created_at": "2023-08-23T10:30:00.000Z",
  • "organization_id": 12345,
  • "email_design_system_id": 12345,
  • "email_content": {
    },
  • "default_locale": "en-US",
  • "locales": [
    ],
  • "updated_at": "2023-08-23T10:30:00.000Z",
  • "last_updated_by": {},
  • "create_with_ai": false,
  • "prompt": "Write a welcome email to a new customer",
  • "ai_generation_status": "generating",
  • "ai_agent_id": 12345
}

Get Email

Retrieves an email by ID.

Authorizations:
CookieAuthBearerAuth
path Parameters
id
required
integer

Email ID

Responses

Response samples

Content type
application/json
{
  • "id": 12345,
  • "name": "My Email",
  • "project_id": 12345,
  • "created_at": "2023-08-23T10:30:00.000Z",
  • "organization_id": 12345,
  • "email_design_system_id": 12345,
  • "email_content": {
    },
  • "default_locale": "en-US",
  • "locales": [
    ],
  • "updated_at": "2023-08-23T10:30:00.000Z",
  • "last_updated_by": {},
  • "create_with_ai": false,
  • "prompt": "Write a welcome email to a new customer",
  • "ai_generation_status": "generating",
  • "ai_agent_id": 12345
}

Update Email

Updates an email.

Authorizations:
CookieAuthBearerAuth
path Parameters
id
required
integer

Email ID

Request Body schema: application/json
name
string
object (EmailContent)
default_locale
string (Locale)
Enum: "ar-SA" "bn-BD" "bn-IN" "cs-CZ" "da-DK" "de-AT" "de-CH" "de-DE" "el-GR" "en-AU" "en-CA" "en-GB" "en-IE" "en-IN" "en-NZ" "en-US" "en-ZA" "es-AR" "es-CL" "es-CO" "es-ES" "es-MX" "es-US" "fi-FI" "fr-BE" "fr-CA" "fr-CH" "fr-FR" "he-IL" "hi-IN" "hu-HU" "id-ID" "it-CH" "it-IT" "ja-JP" "ko-KR" "nl-BE" "nl-NL" "no-NO" "pl-PL" "pt-BR" "pt-PT" "ro-RO" "ru-RU" "sk-SK" "sv-SE" "ta-IN" "ta-LK" "th-TH" "tr-TR" "zh-CN" "zh-HK"
locales
Array of strings (Locale)
Items Enum: "ar-SA" "bn-BD" "bn-IN" "cs-CZ" "da-DK" "de-AT" "de-CH" "de-DE" "el-GR" "en-AU" "en-CA" "en-GB" "en-IE" "en-IN" "en-NZ" "en-US" "en-ZA" "es-AR" "es-CL" "es-CO" "es-ES" "es-MX" "es-US" "fi-FI" "fr-BE" "fr-CA" "fr-CH" "fr-FR" "he-IL" "hi-IN" "hu-HU" "id-ID" "it-CH" "it-IT" "ja-JP" "ko-KR" "nl-BE" "nl-NL" "no-NO" "pl-PL" "pt-BR" "pt-PT" "ro-RO" "ru-RU" "sk-SK" "sv-SE" "ta-IN" "ta-LK" "th-TH" "tr-TR" "zh-CN" "zh-HK"

Responses

Request samples

Content type
application/json
{
  • "name": "string",
  • "email_content": {
    },
  • "default_locale": "en-US",
  • "locales": [
    ]
}

Response samples

Content type
application/json
{
  • "id": 12345,
  • "name": "My Email",
  • "project_id": 12345,
  • "created_at": "2023-08-23T10:30:00.000Z",
  • "organization_id": 12345,
  • "email_design_system_id": 12345,
  • "email_content": {
    },
  • "default_locale": "en-US",
  • "locales": [
    ],
  • "updated_at": "2023-08-23T10:30:00.000Z",
  • "last_updated_by": {},
  • "create_with_ai": false,
  • "prompt": "Write a welcome email to a new customer",
  • "ai_generation_status": "generating",
  • "ai_agent_id": 12345
}

Delete Email

Deletes an email.

Authorizations:
CookieAuthBearerAuth
path Parameters
id
required
integer

Email ID

Responses

Create Email Translation

Creates a new Email Translation.

Authorizations:
CookieAuthBearerAuth
path Parameters
id
required
integer

Email ID

Request Body schema: application/json
target_locales
required
Array of strings

Responses

Request samples

Content type
application/json
{
  • "target_locales": [
    ]
}

Response samples

Content type
application/json
{
  • "id": 12345,
  • "email_id": 12345,
  • "organization_id": 12345,
  • "target_locales": [
    ],
  • "status": "in_progress",
  • "locale_statuses": {
    }
}

Get Email Translation

Retrieves an email translation.

Authorizations:
CookieAuthBearerAuth
path Parameters
id
required
integer

Email ID

email_translation_id
required
integer

Email Translation ID

Responses

Response samples

Content type
application/json
{
  • "id": 12345,
  • "email_id": 12345,
  • "organization_id": 12345,
  • "target_locales": [
    ],
  • "status": "in_progress",
  • "locale_statuses": {
    }
}

Get Email translation spreadsheet

Retrieves the content CSV for an email.

Authorizations:
CookieAuthBearerAuth
path Parameters
id
required
integer

Email ID

Responses

Response samples

Content type
application/json
{
  • "message": "Record not found"
}

Upload Email Translation Spreadsheet

Uploads a CSV file to update an email translation.

Authorizations:
CookieAuthBearerAuth
path Parameters
id
required
integer

Email ID

Request Body schema: multipart/form-data
csv_file
required
string <binary>

Responses

Response samples

Content type
application/json
{
  • "id": 12345,
  • "name": "My Email",
  • "project_id": 12345,
  • "created_at": "2023-08-23T10:30:00.000Z",
  • "organization_id": 12345,
  • "email_design_system_id": 12345,
  • "email_content": {
    },
  • "default_locale": "en-US",
  • "locales": [
    ],
  • "updated_at": "2023-08-23T10:30:00.000Z",
  • "last_updated_by": {},
  • "create_with_ai": false,
  • "prompt": "Write a welcome email to a new customer",
  • "ai_generation_status": "generating",
  • "ai_agent_id": 12345
}

Exports

List Exports

Retrieves the exports.

Authorizations:
CookieAuthBearerAuth
query Parameters
per
integer
Default: 10

Number of records per page

page
integer
Default: 1

Page number

Responses

Response samples

Content type
application/json
{
  • "results": [
    ],
  • "pagination": {
    }
}

Create Export

Creates a new export.

Authorizations:
CookieAuthBearerAuth
Request Body schema: application/json
connector_id
integer or null
email_id
required
integer
export_type
required
string
Enum: "html" "connector" "json"
dynamic_content_profile_id
string or null
required
object (ExportOptions)

Responses

Request samples

Content type
application/json
{
  • "connector_id": 0,
  • "email_id": 0,
  • "export_type": "html",
  • "dynamic_content_profile_id": "string",
  • "options": {
    }
}

Response samples

Content type
application/json
{
  • "id": 12345,
  • "organization_id": 12345,
  • "connector_id": 12345,
  • "email_id": 12345,
  • "dynamic_content_profile_id": "a8c5c5c0-5b1a-4b5a-9b0a-5e8b5c5c5c5c",
  • "status": "in_progress",
  • "export_type": "html",
  • "options": {
    },
  • "integration_name": "Brevo",
  • "metadata": {
    },
  • "export_errors": {
    },
  • "created_at": "2023-08-23T10:30:00.000Z",
  • "updated_at": "2023-08-23T10:30:00.000Z",
  • "download_zip_url": "https://www.example.com/download.zip",
  • "download_json_url": "https://www.example.com/download.json",
  • "open_in_integration_url": "https://www.example.com/integrations/mailchimp/export/12345"
}

Get Export

Retrieves an export.

Authorizations:
CookieAuthBearerAuth
path Parameters
id
required
integer

Export ID

Responses

Response samples

Content type
application/json
{
  • "id": 12345,
  • "organization_id": 12345,
  • "connector_id": 12345,
  • "email_id": 12345,
  • "dynamic_content_profile_id": "a8c5c5c0-5b1a-4b5a-9b0a-5e8b5c5c5c5c",
  • "status": "in_progress",
  • "export_type": "html",
  • "options": {
    },
  • "integration_name": "Brevo",
  • "metadata": {
    },
  • "export_errors": {
    },
  • "created_at": "2023-08-23T10:30:00.000Z",
  • "updated_at": "2023-08-23T10:30:00.000Z",
  • "download_zip_url": "https://www.example.com/download.zip",
  • "download_json_url": "https://www.example.com/download.json",
  • "open_in_integration_url": "https://www.example.com/integrations/mailchimp/export/12345"
}

Email Design Systems

List Email Design Systems

Retrieves the email design systems for the currently logged in user.

Authorizations:
CookieAuthBearerAuth
query Parameters
per
integer
Default: 10

Number of records per page

page
integer
Default: 1

Page number

archived
string
Default: false
Enum: "true" "false" "all"
Example: archived=false

Filter projects by archive status:

  • false (default): Only return non-archived projects
  • true: Only return archived projects
  • all: Return both archived and non-archived projects

Responses

Response samples

Content type
application/json
{
  • "results": [
    ],
  • "pagination": {
    }
}

Create Email Design System

Creates a new email design system.

Authorizations:
CookieAuthBearerAuth
Request Body schema: application/json
name
required
string
description
string or null

Responses

Request samples

Content type
application/json
{
  • "name": "string",
  • "description": "string"
}

Response samples

Content type
application/json
{
  • "id": 12345,
  • "name": "My Email Design System",
  • "description": "My Email Design System",
  • "created_at": "2023-08-23T10:30:00.000Z",
  • "updated_at": "2023-08-23T10:30:00.000Z",
  • "organization_id": 12345,
  • "screenshot_url": "https://www.example.com/screenshot.png",
  • "upload_status": "success",
  • "create_with_ai": false,
  • "prompt": "I want an email design system with a header, a footer, and a content section.",
  • "ai_generation_status": "generating",
  • "archived": false
}

Get Email Design System

Retrieves an email design system.

Authorizations:
CookieAuthBearerAuth
path Parameters
id
required
integer

Email Design System ID

Responses

Response samples

Content type
application/json
{
  • "id": 12345,
  • "name": "My Email Design System",
  • "description": "My Email Design System",
  • "created_at": "2023-08-23T10:30:00.000Z",
  • "updated_at": "2023-08-23T10:30:00.000Z",
  • "organization_id": 12345,
  • "screenshot_url": "https://www.example.com/screenshot.png",
  • "upload_status": "success",
  • "create_with_ai": false,
  • "prompt": "I want an email design system with a header, a footer, and a content section.",
  • "ai_generation_status": "generating",
  • "archived": false
}

Update Email Design System

Updates an email design system.

Authorizations:
CookieAuthBearerAuth
path Parameters
id
required
integer

Email Design System ID

Request Body schema: application/json
name
string
description
string or null
archived
boolean or null

Responses

Request samples

Content type
application/json
{
  • "name": "string",
  • "description": "string",
  • "archived": true
}

Response samples

Content type
application/json
{
  • "id": 12345,
  • "name": "My Email Design System",
  • "description": "My Email Design System",
  • "created_at": "2023-08-23T10:30:00.000Z",
  • "updated_at": "2023-08-23T10:30:00.000Z",
  • "organization_id": 12345,
  • "screenshot_url": "https://www.example.com/screenshot.png",
  • "upload_status": "success",
  • "create_with_ai": false,
  • "prompt": "I want an email design system with a header, a footer, and a content section.",
  • "ai_generation_status": "generating",
  • "archived": false
}

Delete Email Design System

Deletes an email design system.

Authorizations:
CookieAuthBearerAuth
path Parameters
id
required
integer

Email Design System ID

Responses

Parse Email Design System HTML

Parses an Email Design System HTML into a JSON representation.

Authorizations:
CookieAuthBearerAuth
Request Body schema: application/json
html
required
string

Responses

Request samples

Content type
application/json
{
  • "html": "string"
}

Response samples

Content type
application/json
{
  • "container_component": {
    },
  • "components": [
    ]
}

Get Email Design System HTML

Retrieves an Email Design System HTML.

Authorizations:
CookieAuthBearerAuth
path Parameters
emailDesignSystemId
required
integer

Email Design System ID

Responses

Response samples

Content type
application/json
{
  • "html": "<html><head></head><body><p>Hello, World!</p></body></html>"
}

Update Email Design System HTML

Updates an email design system html for the currently logged in user.

Authorizations:
CookieAuthBearerAuth
path Parameters
emailDesignSystemId
required
integer

Email Design System ID

Request Body schema: application/json
html
required
string

Responses

Request samples

Content type
application/json
{
  • "html": "string"
}

Response samples

Content type
application/json
{
  • "html": "<html><head></head><body><p>Hello, World!</p></body></html>"
}

Reorder Components

Reorders the components.

Authorizations:
CookieAuthBearerAuth
path Parameters
emailDesignSystemId
required
integer

Email Design System ID

Request Body schema: application/json
component_ids
required
Array of integers

Responses

Request samples

Content type
application/json
{
  • "component_ids": [
    ]
}

Response samples

Content type
application/json
{
  • "message": "Record not found"
}

Components

List Components

Retrieves the components.

Authorizations:
CookieAuthBearerAuth
path Parameters
emailDesignSystemId
required
integer

Email Design System ID

Responses

Response samples

Content type
application/json
{
  • "results": [
    ]
}

Create Component

Creates a new component.

Authorizations:
CookieAuthBearerAuth
path Parameters
emailDesignSystemId
required
integer

Email Design System ID

Request Body schema: application/json
name
required
string
label
required
string
template
required
string
required
Array of TextFieldDefinition (object) or NumberFieldDefinition (object) or EnumFieldDefinition (object) or BooleanFieldDefinition (object) or UrlFieldDefinition (object) or ImageFieldDefinition (object) or ColorFieldDefinition (object) or RichTextFieldDefinition (object) (FieldDefinition)

Responses

Request samples

Content type
application/json
{
  • "name": "string",
  • "label": "string",
  • "template": "string",
  • "field_definitions": [
    ]
}

Response samples

Content type
application/json
{
  • "id": 12345,
  • "name": "MyComponent",
  • "label": "My Component",
  • "email_design_system_id": 12345,
  • "updated_at": "2023-08-23T10:30:00.000Z",
  • "created_at": "2023-08-23T10:30:00.000Z",
  • "container": false,
  • "template": "<div>My Component</div>",
  • "field_definitions": [
    ],
  • "screenshot_url": "https://www.example.com/screenshot.png",
  • "position": 1
}

Get Component

Retrieves a component.

Authorizations:
CookieAuthBearerAuth
path Parameters
id
required
integer

Component ID

emailDesignSystemId
required
integer

Email Design System ID

Responses

Response samples

Content type
application/json
{
  • "id": 12345,
  • "name": "MyComponent",
  • "label": "My Component",
  • "email_design_system_id": 12345,
  • "updated_at": "2023-08-23T10:30:00.000Z",
  • "created_at": "2023-08-23T10:30:00.000Z",
  • "container": false,
  • "template": "<div>My Component</div>",
  • "field_definitions": [
    ],
  • "screenshot_url": "https://www.example.com/screenshot.png",
  • "position": 1
}

Update Component

Updates a component.

Authorizations:
CookieAuthBearerAuth
path Parameters
id
required
integer

Component ID

emailDesignSystemId
required
integer

Email Design System ID

Request Body schema: application/json
name
string
label
string
template
string
Array of TextFieldDefinition (object) or NumberFieldDefinition (object) or EnumFieldDefinition (object) or BooleanFieldDefinition (object) or UrlFieldDefinition (object) or ImageFieldDefinition (object) or ColorFieldDefinition (object) or RichTextFieldDefinition (object) (FieldDefinition)

Responses

Request samples

Content type
application/json
{
  • "name": "string",
  • "label": "string",
  • "template": "string",
  • "field_definitions": [
    ]
}

Response samples

Content type
application/json
{
  • "id": 12345,
  • "name": "MyComponent",
  • "label": "My Component",
  • "email_design_system_id": 12345,
  • "updated_at": "2023-08-23T10:30:00.000Z",
  • "created_at": "2023-08-23T10:30:00.000Z",
  • "container": false,
  • "template": "<div>My Component</div>",
  • "field_definitions": [
    ],
  • "screenshot_url": "https://www.example.com/screenshot.png",
  • "position": 1
}

Delete Component

Deletes a component.

Authorizations:
CookieAuthBearerAuth
path Parameters
id
required
integer

Component ID

emailDesignSystemId
required
integer

Email Design System ID

Responses

Response samples

Content type
application/json
{
  • "message": "Record not found"
}

Dynamic Content Profiles

List Dynamic Content Profiles

Retrieves the dynamic content profiles for the currently logged in user.

Authorizations:
CookieAuthBearerAuth
query Parameters
per
integer
Default: 10

Number of records per page

page
integer
Default: 1

Page number

Responses

Response samples

Content type
application/json
{
  • "results": [
    ],
  • "pagination": {
    }
}

Create Dynamic Content Profile

Creates a new DynamicContentProfile for the currently logged in user.

Authorizations:
CookieAuthBearerAuth
Request Body schema: application/json
name
required
string

Responses

Request samples

Content type
application/json
{
  • "name": "Mailchimp Profile"
}

Response samples

Content type
application/json
{
  • "id": "uuid TODO",
  • "name": "Mailchimp Profile",
  • "created_at": "2023-08-23T10:30:00.000Z",
  • "updated_at": "2023-08-23T10:30:00.000Z",
  • "organization_id": 12345
}

Get Dynamic Content Profile

Retrieves a DynamicContentProfile.

Authorizations:
CookieAuthBearerAuth
path Parameters
id
required
string

DynamicContentProfile ID

Responses

Response samples

Content type
application/json
{
  • "id": "uuid TODO",
  • "name": "Mailchimp Profile",
  • "created_at": "2023-08-23T10:30:00.000Z",
  • "updated_at": "2023-08-23T10:30:00.000Z",
  • "organization_id": 12345
}

Update Dynamic Content Profile

Updates a DynamicContentProfile.

Authorizations:
CookieAuthBearerAuth
path Parameters
id
required
string

Conditional ID

Request Body schema: application/json
name
string

Responses

Request samples

Content type
application/json
{
  • "name": "Mailchimp Profile"
}

Response samples

Content type
application/json
{
  • "id": "uuid TODO",
  • "name": "Mailchimp Profile",
  • "created_at": "2023-08-23T10:30:00.000Z",
  • "updated_at": "2023-08-23T10:30:00.000Z",
  • "organization_id": 12345
}

Delete Dynamic Content Profile

Deletes a DynamicContentProfile.

Authorizations:
CookieAuthBearerAuth
path Parameters
id
required
string

DynamicContentProfile ID

Responses

Response samples

Content type
application/json
{
  • "message": "Record not found"
}

Conditionals

List Conditionals

Retrieves the conditionals.

Authorizations:
CookieAuthBearerAuth
query Parameters
per
integer
Default: 10

Number of records per page

page
integer
Default: 1

Page number

Responses

Response samples

Content type
application/json
{
  • "results": [
    ],
  • "pagination": {
    }
}

Create Conditionals

Creates a new conditional.

Authorizations:
CookieAuthBearerAuth
Request Body schema: application/json
label
required
string
default_value
required
string
object (DynamicContentProfileValues)

Responses

Request samples

Content type
application/json
{
  • "label": "Over age 30",
  • "default_value": "TODO",
  • "dynamic_content_profile_values": {
    }
}

Response samples

Content type
application/json
{
  • "id": 12345,
  • "label": "Over age 30s",
  • "default_syntax": {
    },
  • "branches": [
    ],
  • "created_at": "2023-08-23T10:30:00.000Z",
  • "updated_at": "2023-08-23T10:30:00.000Z",
  • "organization_id": 12345,
  • "dynamic_content_profile_syntaxes": {
    }
}

Get Conditional

Retrieves a conditional.

Authorizations:
CookieAuthBearerAuth
path Parameters
id
required
integer

Conditional ID

Responses

Response samples

Content type
application/json
{
  • "id": 12345,
  • "label": "Over age 30s",
  • "default_syntax": {
    },
  • "branches": [
    ],
  • "created_at": "2023-08-23T10:30:00.000Z",
  • "updated_at": "2023-08-23T10:30:00.000Z",
  • "organization_id": 12345,
  • "dynamic_content_profile_syntaxes": {
    }
}

Update Conditional

Updates a conditional.

Authorizations:
CookieAuthBearerAuth
path Parameters
id
required
integer

Conditional ID

Request Body schema: application/json
label
string
default_value
string
object (DynamicContentProfileValues)

Responses

Request samples

Content type
application/json
{
  • "label": "Over Age 30s",
  • "default_value": "TODO",
  • "dynamic_content_profile_values": {
    }
}

Response samples

Content type
application/json
{
  • "id": 12345,
  • "label": "Over age 30s",
  • "default_syntax": {
    },
  • "branches": [
    ],
  • "created_at": "2023-08-23T10:30:00.000Z",
  • "updated_at": "2023-08-23T10:30:00.000Z",
  • "organization_id": 12345,
  • "dynamic_content_profile_syntaxes": {
    }
}

Delete Conditional

Deletes a conditional.

Authorizations:
CookieAuthBearerAuth
path Parameters
id
required
integer

Conditional ID

Responses

Response samples

Content type
application/json
{
  • "message": "Record not found"
}

PersonalizationTags

List PersonalizationTags

Retrieves the personalization_tags.

Authorizations:
CookieAuthBearerAuth
query Parameters
per
integer
Default: 10

Number of records per page

page
integer
Default: 1

Page number

Responses

Response samples

Content type
application/json
{
  • "results": [
    ],
  • "pagination": {
    }
}

Create PersonalizationTag

Creates a new personalization_tag.

Authorizations:
CookieAuthBearerAuth
Request Body schema: application/json
label
required
string
default_value
required
string
example_value
required
string
object (DynamicContentProfileValues)

Responses

Request samples

Content type
application/json
{
  • "label": "First name",
  • "default_value": "{{firstName}}",
  • "example_value": "John",
  • "dynamic_content_profile_values": {
    }
}

Response samples

Content type
application/json
{
  • "id": 12345,
  • "label": "First name",
  • "default_value": "{{firstName}}",
  • "example_value": "John",
  • "created_at": "2023-08-23T10:30:00.000Z",
  • "updated_at": "2023-08-23T10:30:00.000Z",
  • "organization_id": 12345,
  • "dynamic_content_profile_values": {
    }
}

Get PersonalizationTag

Retrieves a personalization_tag.

Authorizations:
CookieAuthBearerAuth
path Parameters
id
required
integer

PersonalizationTag ID

Responses

Response samples

Content type
application/json
{
  • "id": 12345,
  • "label": "First name",
  • "default_value": "{{firstName}}",
  • "example_value": "John",
  • "created_at": "2023-08-23T10:30:00.000Z",
  • "updated_at": "2023-08-23T10:30:00.000Z",
  • "organization_id": 12345,
  • "dynamic_content_profile_values": {
    }
}

Update PersonalizationTag

Updates a personalization_tag.

Authorizations:
CookieAuthBearerAuth
path Parameters
id
required
integer

PersonalizationTag ID

Request Body schema: application/json
label
string
default_value
string
example_value
string
object (DynamicContentProfileValues)

Responses

Request samples

Content type
application/json
{
  • "label": "First name",
  • "default_value": "{{firstName}}",
  • "example_value": "John",
  • "dynamic_content_profile_values": {
    }
}

Response samples

Content type
application/json
{
  • "id": 12345,
  • "label": "First name",
  • "default_value": "{{firstName}}",
  • "example_value": "John",
  • "created_at": "2023-08-23T10:30:00.000Z",
  • "updated_at": "2023-08-23T10:30:00.000Z",
  • "organization_id": 12345,
  • "dynamic_content_profile_values": {
    }
}

Delete PersonalizationTag

Deletes a personalization_tag.

Authorizations:
CookieAuthBearerAuth
path Parameters
id
required
integer

PersonalizationTag ID

Responses

Response samples

Content type
application/json
{
  • "message": "Record not found"
}

Images

List Images

Retrieves the images.

Authorizations:
CookieAuthBearerAuth
query Parameters
per
integer
Default: 10

Number of records per page

page
integer
Default: 1

Page number

search
string

Filter images by search term

Responses

Response samples

Content type
application/json
{
  • "results": [
    ],
  • "pagination": {
    }
}

Create Image

Creates a new image.

Authorizations:
CookieAuthBearerAuth
Request Body schema: multipart/form-data
file
required
string <binary>

Responses

Response samples

Content type
application/json
{
  • "id": "bd1c1b82-1a7b-4f0f-b079-30c1d4189bed",
  • "name": "My Image",
  • "filename": "image.png",
  • "width": 100,
  • "height": 100,
  • "file_size": 1000,
  • "created_at": "2023-08-23T10:30:00.000Z",
  • "updated_at": "2023-08-23T10:30:00.000Z",
  • "organization_id": 12345,
  • "public_url": "https://www.example.com/image.png"
}

Update Image

Updates an image.

Authorizations:
CookieAuthBearerAuth
path Parameters
id
required
string

Image ID

Request Body schema: application/json
name
string

Responses

Request samples

Content type
application/json
{
  • "name": "New Name"
}

Response samples

Content type
application/json
{
  • "id": "bd1c1b82-1a7b-4f0f-b079-30c1d4189bed",
  • "name": "My Image",
  • "filename": "image.png",
  • "width": 100,
  • "height": 100,
  • "file_size": 1000,
  • "created_at": "2023-08-23T10:30:00.000Z",
  • "updated_at": "2023-08-23T10:30:00.000Z",
  • "organization_id": 12345,
  • "public_url": "https://www.example.com/image.png"
}

Delete Image

Deletes an image.

Authorizations:
CookieAuthBearerAuth
path Parameters
id
required
string

Image ID

Responses

Response samples

Content type
application/json
{
  • "message": "Record not found"
}

Users

List users

Retrieves the users.

Authorizations:
CookieAuthBearerAuth
query Parameters
per
integer
Default: 10

Number of records per page

page
integer
Default: 1

Page number

search
string

Filter users by search term

Responses

Response samples

Content type
application/json
{
  • "results": [
    ],
  • "pagination": {
    }
}

Create user

Creates a new user.

Authorizations:
CookieAuthBearerAuth
Request Body schema: application/json
first_name
required
string
last_name
required
string
email
required
string
role
required
string
Enum: "admin" "developer" "editor" "viewer"

Responses

Request samples

Content type
application/json
{
  • "first_name": "string",
  • "last_name": "string",
  • "email": "string",
  • "role": "admin"
}

Response samples

Content type
application/json
{
  • "id": 12345,
  • "first_name": "Joe",
  • "last_name": "Cottam",
  • "email": "[email protected]",
  • "created_at": "2023-08-23T10:30:00.000Z",
  • "updated_at": "2023-08-23T10:30:00.000Z",
  • "requires_email_confirmation": false,
  • "organization_id": 12345,
  • "role": "admin",
  • "invitation_sent_at": "2023-08-23T10:30:00.000Z",
  • "invitation_accepted_at": "2023-08-23T10:30:00.000Z",
  • "permissions": [
    ],
  • "profile_image_url": "https://example.com/profile.jpg",
  • "wants_marketing_emails": false
}

Get user

Retrieves a user.

Authorizations:
CookieAuthBearerAuth
path Parameters
id
required
integer

User ID

Responses

Response samples

Content type
application/json
{
  • "id": 12345,
  • "first_name": "Joe",
  • "last_name": "Cottam",
  • "email": "[email protected]",
  • "created_at": "2023-08-23T10:30:00.000Z",
  • "updated_at": "2023-08-23T10:30:00.000Z",
  • "requires_email_confirmation": false,
  • "organization_id": 12345,
  • "role": "admin",
  • "invitation_sent_at": "2023-08-23T10:30:00.000Z",
  • "invitation_accepted_at": "2023-08-23T10:30:00.000Z",
  • "permissions": [
    ],
  • "profile_image_url": "https://example.com/profile.jpg",
  • "wants_marketing_emails": false
}

Update user

Updates a user.

Authorizations:
CookieAuthBearerAuth
path Parameters
id
required
integer

User ID

Request Body schema: application/json
role
string
Enum: "admin" "developer" "editor" "viewer"

Responses

Request samples

Content type
application/json
{
  • "role": "admin"
}

Response samples

Content type
application/json
{
  • "id": 12345,
  • "first_name": "Joe",
  • "last_name": "Cottam",
  • "email": "[email protected]",
  • "created_at": "2023-08-23T10:30:00.000Z",
  • "updated_at": "2023-08-23T10:30:00.000Z",
  • "requires_email_confirmation": false,
  • "organization_id": 12345,
  • "role": "admin",
  • "invitation_sent_at": "2023-08-23T10:30:00.000Z",
  • "invitation_accepted_at": "2023-08-23T10:30:00.000Z",
  • "permissions": [
    ],
  • "profile_image_url": "https://example.com/profile.jpg",
  • "wants_marketing_emails": false
}

Delete user

Deletes a user.

Authorizations:
CookieAuthBearerAuth
path Parameters
id
required
integer

User ID

Responses

Response samples

Content type
application/json
{
  • "errors": {
    }
}

Connectors

List connectors

Retrieves connectors.

Authorizations:
CookieAuthBearerAuth
query Parameters
per
integer
Default: 10

Number of records per page

page
integer
Default: 1

Page number

Responses

Response samples

Content type
application/json
{}

Creates a connector.

Creates a new connector.

Authorizations:
CookieAuthBearerAuth
Request Body schema: application/json
name
required
string

Connector name

integration_name
required
string

Integration name

required
object

Responses

Request samples

Content type
application/json
{
  • "name": "Mailchimp",
  • "integration_name": "mailchimp",
  • "settings": { }
}

Response samples

Content type
application/json
{}

Get connector

Retrieves a single connector by ID.

Authorizations:
CookieAuthBearerAuth
path Parameters
id
required
integer

Connector ID

Responses

Response samples

Content type
application/json
{}

Update connector

Updates a connector.

Authorizations:
CookieAuthBearerAuth
path Parameters
id
required
integer

Project ID

Request Body schema: application/json
name
string

Connector name

integration_name
string

Integration name

object

Responses

Request samples

Content type
application/json
{
  • "name": "Mailchimp",
  • "integration_name": "mailchimp",
  • "settings": { }
}

Response samples

Content type
application/json
{}

Delete connector

Deletes a connector.

Authorizations:
CookieAuthBearerAuth
path Parameters
id
required
integer

Connector ID

Responses

Response samples

Content type
application/json
{
  • "message": "Record not found"
}

Tools

Convert HTML Email to Text

Converts HTML Email to Text

Authorizations:
CookieAuthBearerAuth
Request Body schema: application/json
html
required
string

Responses

Request samples

Content type
application/json
{
  • "html": "string"
}

Response samples

Content type
application/json
{
  • "text": "string"
}

ExternalConnectorResources

List external connector resources

Retrieves the external connector resources

Authorizations:
CookieAuthBearerAuth
query Parameters
email_id
integer

Email ID

connector_id
integer

Connector ID

Responses

Response samples

Content type
application/json
{
  • "results": [
    ]
}

AIAgents

List AI agents

Retrieves the AI agents

Authorizations:
CookieAuthBearerAuth
query Parameters
per
integer
Default: 10

Number of records per page

page
integer
Default: 1

Page number

Responses

Response samples

Content type
application/json
{
  • "results": [
    ],
  • "pagination": {
    }
}

Create AI agent

Creates a new AI agent.

Authorizations:
CookieAuthBearerAuth
Request Body schema: application/json
name
required
string
company_name
string
company_overview
string
tone
string
guidelines
string

Responses

Request samples

Content type
application/json
{
  • "name": "string",
  • "company_name": "string",
  • "company_overview": "string",
  • "tone": "string",
  • "guidelines": "string"
}

Response samples

Content type
application/json
{
  • "id": 12345,
  • "name": "My AI Agent",
  • "company_name": "My Company",
  • "company_overview": "My Company is a company that makes widgets.",
  • "tone": "My Company is a company that makes widgets.",
  • "guidelines": "My Company is a company that makes widgets.",
  • "created_at": "2023-08-23T10:30:00.000Z",
  • "updated_at": "2023-08-23T10:30:00.000Z"
}

Get AI agent

Retrieves a single AI agent by ID.

Authorizations:
CookieAuthBearerAuth
path Parameters
id
required
integer

AI agent ID

Responses

Response samples

Content type
application/json
{
  • "id": 12345,
  • "name": "My AI Agent",
  • "company_name": "My Company",
  • "company_overview": "My Company is a company that makes widgets.",
  • "tone": "My Company is a company that makes widgets.",
  • "guidelines": "My Company is a company that makes widgets.",
  • "created_at": "2023-08-23T10:30:00.000Z",
  • "updated_at": "2023-08-23T10:30:00.000Z"
}

Update AI agent

Updates a single AI agent by ID.

Authorizations:
CookieAuthBearerAuth
path Parameters
id
required
integer

AI agent ID

Request Body schema: application/json
name
string
company_name
string
company_overview
string
tone
string
guidelines
string

Responses

Request samples

Content type
application/json
{
  • "name": "string",
  • "company_name": "string",
  • "company_overview": "string",
  • "tone": "string",
  • "guidelines": "string"
}

Response samples

Content type
application/json
{
  • "id": 12345,
  • "name": "My AI Agent",
  • "company_name": "My Company",
  • "company_overview": "My Company is a company that makes widgets.",
  • "tone": "My Company is a company that makes widgets.",
  • "guidelines": "My Company is a company that makes widgets.",
  • "created_at": "2023-08-23T10:30:00.000Z",
  • "updated_at": "2023-08-23T10:30:00.000Z"
}

Delete AI agent

Deletes a single AI agent by ID.

Authorizations:
CookieAuthBearerAuth
path Parameters
id
required
integer

AI agent ID

Responses

Response samples

Content type
application/json
{
  • "message": "Record not found"
}

Renders

Render

Renders the selected components of an email design system

Authorizations:
CookieAuthBearerAuth
Request Body schema: application/json
email_design_system_id
required
integer

ID of the email design system

required
object

Responses

Request samples

Content type
application/json
{
  • "email_design_system_id": 0,
  • "content": {
    }
}

Response samples

Content type
application/json
{
  • "html": "string",
  • "created_at": "2023-08-23T10:30:00.000Z"
}