Create a reusable email content block

Creates a workspace-scoped reusable HTML block for Email Builder V2.

POST

https://api.channelautomation.com/api/email/content-blocks

Authorization

BearerAuth
optional
HTTP Bearer (JWT)

WorkspaceAuth
API key in header
required
ApiKeyAuth
optional
API key in header

Header parameters

X-Workspace-Id
string
required
Workspace ID for data isolation

Request body JSON required

name
string
required
slug
optional
string
block_type
optional
header
or
footer
or
offer
or
promo
or
legal
or
custom
design_json
optional
object
rendered_html
optional
string
status
optional
active
or
archived

Returns

201

Content block created.

400

Invalid request.

409

Slug already exists.

500

Internal server error

JSON

error
optional
string
details
optional
string
success
optional
boolean

Create a reusable email content block

curl --request POST \
  --url https://api.channelautomation.com/api/email/content-blocks \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'X-Workspace-Id: <X-Workspace-Id>' \
  --data '
{
  "name": "string",
  "slug": "string",
  "block_type": "header",
  "design_json": {},
  "rendered_html": "string",
  "status": "active"
}
'

const url = 'https://api.channelautomation.com/api/email/content-blocks';
const options = {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'X-Workspace-Id': '<X-Workspace-Id>',
    Authorization: 'Bearer <token>'
  },
  body: JSON.stringify({
    name: 'string',
    slug: 'string',
    block_type: 'header',
    design_json: {},
    rendered_html: 'string',
    status: 'active'
  })
};

fetch(url, options)
  .then(res => res.json())
  .then(json => console.log(json))
  .catch(err => console.error(err));

import requests

url = "https://api.channelautomation.com/api/email/content-blocks"

payload = {
    "name": "string",
    "slug": "string",
    "block_type": "header",
    "design_json": {},
    "rendered_html": "string",
    "status": "active"
}
headers = {
    "Content-Type": "application/json",
    "X-Workspace-Id": "<X-Workspace-Id>",
    "Authorization": "Bearer <token>"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

Response example

{
  "error": "Internal server error",
  "details": "string",
  "success": false
}