Skip to main content
POST
/
api
/
v1
/
transactional
Create Transactional Email
curl --request POST \
  --url https://api.sequenzy.com/api/v1/transactional \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "slug": "<string>",
  "subject": "<string>",
  "previewText": "<string>",
  "html": "<string>",
  "blocks": [
    {}
  ],
  "enabled": true
}
'
{
  "success": true,
  "transactional": {
    "id": "txn_abc123",
    "name": "Password Reset",
    "slug": "password-reset",
    "emailId": "email_abc123",
    "enabled": true,
    "subject": "Reset your password, {{NAME}}",
    "previewText": "Use this link to reset your password.",
    "blocks": [
      {
        "id": "block_123",
        "type": "text",
        "content": "<p>Reset link: {{RESET_URL}}</p>",
        "variant": "html"
      }
    ],
    "variables": ["NAME", "RESET_URL"],
    "createdAt": "2026-05-01T10:30:00Z",
    "updatedAt": "2026-05-01T10:30:00Z"
  }
}
Create a transactional email template that you can send later by API slug. You provide either raw html or Sequenzy blocks for the linked email body.

​
Request

​
name
string
required
Transactional email name.
​
slug
string
API slug used when sending by slug. If omitted, Sequenzy generates one from the name.
​
subject
string
required
Email subject line.
​
previewText
string
Email preview text.
​
html
string
Raw HTML body. Provide either html or blocks, not both.
​
blocks
array
Sequenzy email blocks. Provide either blocks or html, not both. Put block styling under styles; top-level style keys like backgroundColor, backgroundOpacity, borderColor, borderWidth, and borderRadius are normalized into styles.
​
enabled
boolean
Whether this transactional email can be sent immediately. Defaults to true.
curl -X POST "https://api.sequenzy.com/api/v1/transactional" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Password Reset",
    "slug": "password-reset",
    "subject": "Reset your password, {{NAME}}",
    "previewText": "Use this link to reset your password.",
    "html": "<p>Reset link: {{RESET_URL}}</p>"
  }'

​
Responses

{
  "success": true,
  "transactional": {
    "id": "txn_abc123",
    "name": "Password Reset",
    "slug": "password-reset",
    "emailId": "email_abc123",
    "enabled": true,
    "subject": "Reset your password, {{NAME}}",
    "previewText": "Use this link to reset your password.",
    "blocks": [
      {
        "id": "block_123",
        "type": "text",
        "content": "<p>Reset link: {{RESET_URL}}</p>",
        "variant": "html"
      }
    ],
    "variables": ["NAME", "RESET_URL"],
    "createdAt": "2026-05-01T10:30:00Z",
    "updatedAt": "2026-05-01T10:30:00Z"
  }
}