Sequences

Sequences are automated email series that deliver a series of messages to subscribers over time. They're perfect for onboarding flows, educational content, nurture campaigns, and drip marketing. Each sequence contains multiple email templates that are sent based on configured delays and conditions. The Sequences API allows you to retrieve sequences, create sequence emails, and update existing template content programmatically.

Available Endpoints

Method	Endpoint	Name
GET	fetch/sequences	Get Sequences
POST	fetch/sequences/:id/emails/templates	Create Sequence Email
PATCH	fetch/emails/templates/:id	Update Sequence Email

The Sequence Model

The sequence model represents an automated email series with its associated email templates and performance statistics.

Properties

Name
id
Type
string
Description
The unique identifier for the sequence
Name
name
Type
string
Description
The name of the sequence
Name
created_at
Type
datetime
Description
When the sequence was created
Name
email_templates
Type
array
Description
Array of email templates in this sequence, each with id, subject, and stats

GET/v1/fetch/sequences

Get Sequences

Returns a list of all sequences in your account, including their associated email templates and performance statistics.

Query Parameters

Name
site_uuid
Type
string
Description
Your site's unique identifier
Name
page
Type
integer
Description
Page number for pagination (optional)

Response

Returns a list of sequences with their email templates and stats.

POST/v1/fetch/sequences/:id/emails/templates

Create Sequence Email

Creates a new email template inside a sequence.

The sequence id is the sequence prefix ID (for example, sequence_abc123).

Path Parameters

Name
id
Type
string
Description
The sequence prefix ID

Query Parameters

Name
site_uuid
Type
string
Description
Your site's unique identifier

Request Body

Name
email_template.subject
Type
string
Description
Subject line for the new sequence email
Name
email_template.html
Type
string
Description
HTML body for the email
Name
email_template.delay_interval
Type
string
Description
Optional delay unit: minutes, hours, days, or months
Name
email_template.delay_interval_count
Type
integer
Description
Optional delay amount (must be paired with delay_interval)
Name
email_template.inbox_snippet
Type
string
Description
Optional preview text snippet
Name
email_template.editor_choice
Type
string
Description
Optional editor mode

curl -L -u publishableKey:secretKey \
  -X POST "https://app.bentonow.com/api/v1/fetch/sequences/sequence_abc123/emails/templates?site_uuid=ExampleID1234" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{
    "email_template": {
      "subject": "Welcome to Bento",
      "html": "<h1>Hello {{ visitor.first_name }}</h1>",
      "delay_interval": "days",
      "delay_interval_count": 7,
      "inbox_snippet": "Start here",
      "editor_choice": "plain"
    }
  }'

Response

Returns the created email template.

{
  "data": {
    "id": 12345,
    "type": "email_template",
    "attributes": {
      "name": "Welcome to Bento",
      "subject": "Welcome to Bento",
      "html": "<h1>Hello {{ visitor.first_name }}</h1>",
      "created_at": "2026-02-15T10:30:00Z",
      "stats": null
    }
  }
}

PATCH/v1/fetch/emails/templates/:id

Update Sequence Email

Updates an existing sequence email template by template ID.

Update currently supports subject and html only. Other sequence-email fields (delay, snippet, cc/bcc, etc.) are created via the sequence create endpoint.

Path Parameters

Name
id
Type
integer
Description
Email template ID

Query Parameters

Name
site_uuid
Type
string
Description
Your site's unique identifier

Request Body

Name
email_template.subject
Type
string
Description
Updated subject line
Name
email_template.html
Type
string
Description
Updated HTML content

curl -L -u publishableKey:secretKey \
  -X PATCH "https://app.bentonow.com/api/v1/fetch/emails/templates/12345?site_uuid=ExampleID1234" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{
    "email_template": {
      "subject": "Updated subject",
      "html": "<h1>Updated HTML</h1>"
    }
  }'