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

# Create sequence from template

`POST /sequences/from-template`

## Request

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

Creates a draft sequence from a template returned by List Sequence Templates, exactly as the dashboard does. Push-first templates start with a branch on whether the contact is reachable by push (an active device on a platform with APNs, FCM or web push set up); those contacts get push and in-app, everyone else gets email. Waits land between 09:00 and 21:00 in each contact's own timezone, email steps respect the company frequency cap when the template enables it, the template's continue condition becomes the stop condition, and its attribution goal is created on the sequence. Email steps are written by AI in the background; push and in-app copy comes from the template. Every successful call creates another sequence. Requires `sequences:write`.

## Request body

- object
  - `templateId` string, required: Template id, such as `mobile-trial-conversion`.
  - `name` string: Sequence name. Defaults to the template name.

## Response `200`

Draft sequence created

- object
  - `success` boolean
  - `sequence` object
    - `id` string
    - `name` string
    - `status` string
    - `templateId` string
    - `trigger` object: The template trigger (type, eventName, tagName, inactiveDays, description).
    - `channels` string[]
    - `channelStrategy` 'push_first_email_fallback' | 'null', nullable
    - `frequencyCapEnabled` boolean
    - `goalId` string, nullable: Attribution goal created with the sequence.
    - `emailCount` integer
    - `pushCount` integer
    - `inAppCount` integer
    - `enrichmentStatus` 'processing' | 'not_needed'
  - `message` string

## Other responses

- `400`: The template counts down to key dates (calendar templates are created in the dashboard or with Create Sequence and keyDates)
- `401`: Missing or invalid API key
- `403`: The API key lacks `sequences:write`
- `404`: Unknown template id
- `422`: Request shape validation failed (missing or empty `templateId`)
- `500`: The sequence could not be created

## Changes

- **2026-11-05** `3b203b095366`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/sequenzy/apis/sequenzy-api/changes/sequences/from-template/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/e5af1fb27c8d?raw)
