Generate Sequence Email Variations

POST

api

sequences

{sequenceId}

emails

{emailId}

variations

generate

Generate Sequence Email Variations

curl --request POST \
  --url https://api.sequenzy.com/api/v1/sequences/{sequenceId}/emails/{emailId}/variations/generate \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "prompt": "<string>",
  "count": 123,
  "style": "<string>"
}
'

import requests

url = "https://api.sequenzy.com/api/v1/sequences/{sequenceId}/emails/{emailId}/variations/generate"

payload = {
    "prompt": "<string>",
    "count": 123,
    "style": "<string>"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

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

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({prompt: '<string>', count: 123, style: '<string>'})
};

fetch('https://api.sequenzy.com/api/v1/sequences/{sequenceId}/emails/{emailId}/variations/generate', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.sequenzy.com/api/v1/sequences/{sequenceId}/emails/{emailId}/variations/generate",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'prompt' => '<string>',
    'count' => 123,
    'style' => '<string>'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.sequenzy.com/api/v1/sequences/{sequenceId}/emails/{emailId}/variations/generate"

	payload := strings.NewReader("{\n  \"prompt\": \"<string>\",\n  \"count\": 123,\n  \"style\": \"<string>\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.sequenzy.com/api/v1/sequences/{sequenceId}/emails/{emailId}/variations/generate")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"prompt\": \"<string>\",\n  \"count\": 123,\n  \"style\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.sequenzy.com/api/v1/sequences/{sequenceId}/emails/{emailId}/variations/generate")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"prompt\": \"<string>\",\n  \"count\": 123,\n  \"style\": \"<string>\"\n}"

response = http.request(request)
puts response.read_body

{
  "success": true,
  "email": { "emailId": "email_abc123", "nodeId": "node_abc123", "label": "Email 1" },
  "variations": [
    {
      "id": "evar_9xk2",
      "emailId": "email_abc123",
      "parentId": null,
      "label": "V1",
      "name": "New variation",
      "summary": null,
      "prompt": "A few bolder versions",
      "style": "fresh",
      "status": "generating",
      "error": null,
      "subject": null,
      "previewText": null,
      "blocks": null,
      "emailTheme": null,
      "fontFamily": null,
      "position": null,
      "inUse": false,
      "usedAt": null,
      "createdAt": "2026-10-16T09:12:00.000Z",
      "updatedAt": "2026-10-16T09:12:00.000Z"
    }
  ]
}

{
  "error": "This email is a single raw HTML block. Design variations need Sequenzy blocks; change it with POST /sequences/{sequenceId}/emails/edit instead."
}

{
  "error": "Invalid API key"
}

{
  "error": "Email of this sequence not found"
}

{
  "error": "Up to 8 variations can generate at once. Wait for the ones in progress to finish, then try again."
}

{
  "error": "Could not start generating variations. Try again."
}

Starts designing 1 to 4 variations of one email of a sequence with AI, like asking “I like email 1, make a few variations” in the sequence editor’s Emails view. It returns them at once with status: "generating". Each one takes its own direction, planned from your prompt. style sets how far they move: close versions are edits of the email; fresh versions are written anew with their own structure in your brand’s colors and fonts; bold versions also get their own look. The email does not change until you use one. The source is the email as saved. Generation runs in the background and usually takes under a minute: poll List Sequence Email Variations until each one is ready or failed. Each variation succeeds or fails on its own, and one still generating after 10 minutes is reported as failed. Retrying is a new request that creates new variations. An email that is a single raw HTML block can’t be varied; change it with Edit Sequence Emails with AI instead. A/B test steps, steps without an email and steps that send the same email as an earlier step can’t have variations.

Request

string

required

Sequence ID.

string

required

The email’s ID: the emailId of its step from Get Sequence.

string

required

The direction for the new versions, in any language. Up to 2,000 characters.

integer

default:"3"

How many variations to design, from 1 to 4.

string

default:"fresh"

How far the new versions move from the email: close, fresh or bold.

curl -X POST "https://api.sequenzy.com/api/v1/sequences/seq_abc123/emails/email_abc123/variations/generate" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "prompt": "A few bolder versions", "count": 3 }'

Response

Returns 202 Accepted.

object

The email the variations are of: emailId, nodeId (its step) and label.

array

The new variations, all with status: "generating" and blocks: null.

{
  "success": true,
  "email": { "emailId": "email_abc123", "nodeId": "node_abc123", "label": "Email 1" },
  "variations": [
    {
      "id": "evar_9xk2",
      "emailId": "email_abc123",
      "parentId": null,
      "label": "V1",
      "name": "New variation",
      "summary": null,
      "prompt": "A few bolder versions",
      "style": "fresh",
      "status": "generating",
      "error": null,
      "subject": null,
      "previewText": null,
      "blocks": null,
      "emailTheme": null,
      "fontFamily": null,
      "position": null,
      "inUse": false,
      "usedAt": null,
      "createdAt": "2026-10-16T09:12:00.000Z",
      "updatedAt": "2026-10-16T09:12:00.000Z"
    }
  ]
}

{
  "error": "This email is a single raw HTML block. Design variations need Sequenzy blocks; change it with POST /sequences/{sequenceId}/emails/edit instead."
}

{
  "error": "Invalid API key"
}

{
  "error": "Email of this sequence not found"
}

{
  "error": "Up to 8 variations can generate at once. Wait for the ones in progress to finish, then try again."
}

{
  "error": "Could not start generating variations. Try again."
}

A 409 means the email already has variations generating and this request would take it past 8 at once. Wait for some to finish, then send the request again. A 503 means generation could not be started; any variations it created are marked failed.

Generate Sequence Email Variations

curl --request POST \
  --url https://api.sequenzy.com/api/v1/sequences/{sequenceId}/emails/{emailId}/variations/generate \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "prompt": "<string>",
  "count": 123,
  "style": "<string>"
}
'

import requests

url = "https://api.sequenzy.com/api/v1/sequences/{sequenceId}/emails/{emailId}/variations/generate"

payload = {
    "prompt": "<string>",
    "count": 123,
    "style": "<string>"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

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

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({prompt: '<string>', count: 123, style: '<string>'})
};

fetch('https://api.sequenzy.com/api/v1/sequences/{sequenceId}/emails/{emailId}/variations/generate', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.sequenzy.com/api/v1/sequences/{sequenceId}/emails/{emailId}/variations/generate",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'prompt' => '<string>',
    'count' => 123,
    'style' => '<string>'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.sequenzy.com/api/v1/sequences/{sequenceId}/emails/{emailId}/variations/generate"

	payload := strings.NewReader("{\n  \"prompt\": \"<string>\",\n  \"count\": 123,\n  \"style\": \"<string>\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.sequenzy.com/api/v1/sequences/{sequenceId}/emails/{emailId}/variations/generate")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"prompt\": \"<string>\",\n  \"count\": 123,\n  \"style\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.sequenzy.com/api/v1/sequences/{sequenceId}/emails/{emailId}/variations/generate")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"prompt\": \"<string>\",\n  \"count\": 123,\n  \"style\": \"<string>\"\n}"

response = http.request(request)
puts response.read_body

{
  "success": true,
  "email": { "emailId": "email_abc123", "nodeId": "node_abc123", "label": "Email 1" },
  "variations": [
    {
      "id": "evar_9xk2",
      "emailId": "email_abc123",
      "parentId": null,
      "label": "V1",
      "name": "New variation",
      "summary": null,
      "prompt": "A few bolder versions",
      "style": "fresh",
      "status": "generating",
      "error": null,
      "subject": null,
      "previewText": null,
      "blocks": null,
      "emailTheme": null,
      "fontFamily": null,
      "position": null,
      "inUse": false,
      "usedAt": null,
      "createdAt": "2026-10-16T09:12:00.000Z",
      "updatedAt": "2026-10-16T09:12:00.000Z"
    }
  ]
}

{
  "error": "This email is a single raw HTML block. Design variations need Sequenzy blocks; change it with POST /sequences/{sequenceId}/emails/edit instead."
}

{
  "error": "Invalid API key"
}

{
  "error": "Email of this sequence not found"
}

{
  "error": "Up to 8 variations can generate at once. Wait for the ones in progress to finish, then try again."
}

{
  "error": "Could not start generating variations. Try again."
}

​Request

​Response

Request

Response