---
title: "Create sequence from gallery example"
method: POST
path: "/sequences/from-example"
tags: ["Sequences"]
---

# Create sequence from gallery example

`POST /sequences/from-example`

## Request

- Base URL: `https://api.sequenzy.com/api/v1`
- URL: `https://api.sequenzy.com/api/v1/sequences/from-example`
- Auth: HTTP bearer

Clones a public sequence from the Sequenzy email gallery into a draft sequence for your company. The draft keeps the example's trigger family and send timing, up to 12 emails (the first 12 unless `stepNumbers` picks which), and AI then writes every email in your brand in the background (usually 30 to 60 seconds). Poll [Get Sequence](/api-reference/sequences/get) until `enrichmentStatus` is `complete`. The sequence sends nothing until you enable it. Every successful call creates another sequence, so do not retry after a success. Requires `sequences:write`.

## Request body

- object: Identify the example with `url`, or with `brand` and `sequence`. Not both.
  - `url` string: Gallery sequence page URL, such as `https://sequenzy.com/email-examples/brands/linear/sequences/onboarding`.
  - `brand` string: Gallery brand slug. Use with `sequence` instead of `url`.
  - `sequence` string: Gallery sequence slug. Use with `brand` instead of `url`.
  - `brief` string: Optional direction applied to every email. Takes priority over the example.
  - `name` string: Sequence name. Defaults to the sequence type, such as "Onboarding sequence".
  - `stepNumbers` integer[]: Which of the example's emails to clone, as 1-based positions in the gallery sequence (its Email 1, Email 2 and so on), not the `stepNumber` of the created sequence's steps. Duplicates are ignored and order does not matter. Each email keeps its original timing from the trigger. Defaults to the first 12. An empty list, more than 12 distinct positions, or a position outside the sequence returns 400; a list of more than 100 entries or non-integer entries fails validation with 422.
  - `emailStyle` 'visual' | 'plain': Generated email style. Defaults to the company's email style preference.

## Response `200`

Draft sequence created; emails are being written

- object
  - `success` boolean
  - `sequence` object
    - `id` string
    - `name` string
    - `status` string
    - `trigger` string: Trigger node type, such as `trigger_list` or `trigger_event`.
    - `triggerDescription` string
    - `eventName` string: Entry event for event triggers (`ecommerce.cart_abandoned` or `ecommerce.order_placed`).
    - `tagName` string: Entry tag for tag triggers (`inactive` for re-engagement).
    - `stopCondition` object: The early exit rule the sequence was created with, when it has one. Abandoned cart stops on `ecommerce.order_placed`; re-engagement stops when the `inactive` tag is removed (`does_not_have_tag`).
      - `type` string
      - `value` string, nullable
      - `matchConfig` object, nullable
    - `emailCount` integer
    - `enrichmentStatus` 'processing' | 'not_queued': `processing` while AI writes the emails; poll Get Sequence, which reports `pending`, then `in_progress`, then `complete`. `not_queued` means the draft exists but writing could not start: open it in the dashboard to write the emails, and do not create it again.
    - `steps` object[]
      - `stepNumber` integer
      - `title` string
      - `delayMs` integer: Wait before this email, after the trigger or the previous email.
      - `originalDay` integer: Day this email arrived in the example.
  - `example` object
    - `brand` string
    - `name` string
    - `url` string
    - `omittedEmailCount` integer: Emails in the example that were not cloned (not chosen in `stepNumbers`, or beyond the 12-step limit).
    - `stepNumbers` integer[]: Positions of the cloned emails in the example, ascending.
  - `message` string
  - `warnings` string[]: Present when email writing could not be queued.

## Other responses

- `400`: Missing, conflicting or invalid example reference (for example an email URL), or invalid `stepNumbers`
- `401`: Unauthorized
- `403`: API key lacks `sequences:write`
- `404`: The example is not public (code `EXAMPLE_NOT_FOUND`), or the email gallery is not available (code `EMAIL_GALLERY_UNAVAILABLE`)
- `422`: The request body or parameters are invalid
- `500`: The sequence could not be created. Nothing was saved, so you can retry.

## Changes

- **2026-10-16** `db3873ca3d4d`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/sequenzy/apis/sequenzy-api/changes/sequences/from-example/post.md)

---

[API](https://skmtc.dev/sequenzy/apis/sequenzy-api.md) - [All operations](https://skmtc.dev/sequenzy/apis/sequenzy-api/llms.txt) - [OpenAPI document](https://skmtc.dev/sequenzy/apis/sequenzy-api/revisions/8156dc12d8b4?raw)