> ## Documentation Index
> Fetch the complete documentation index at: https://docs.topo.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Sequence Templates API — Read Your Outreach Playbooks

> Fetch the outreach playbooks configured in your workspace — the templates that define steps, schedule, and daily targets for automated sequences.

A **sequence template** is the top-level outreach playbook for a given target segment. It defines the full sequence of steps (emails, LinkedIn messages, manual tasks), the sending schedule and timezone, and how many new leads to process each day. When a contact is enrolled, Topo instantiates a live [sequence](/api-reference/sequences) from the template and executes steps on the configured schedule.

The Sequence Templates API gives you read access to the templates in your workspace. This is useful for building integration UIs (e.g., a lead import tool that lets users pick which playbook to enroll contacts into) or for querying template metadata in analytics pipelines.

<Note>
  All Sequence Templates endpoints require the `sequences:read` scope. Sequence templates are **read-only** via the API — create and edit templates in the Topo UI.
</Note>

## Template statuses

| Status          | Description                                                                                               |
| --------------- | --------------------------------------------------------------------------------------------------------- |
| `PENDING_SETUP` | The template is being configured and is not yet ready to accept leads.                                    |
| `ACTIVE`        | The template is live and can accept new lead enrollments.                                                 |
| `INACTIVE`      | The template has been deactivated; existing sequences continue but no new leads are enrolled.             |
| `FINISHING`     | The template is winding down; existing sequences continue to execute but no new enrollments are accepted. |
| `ARCHIVED`      | The template has been archived and is no longer in use.                                                   |

<Tip>
  Only `ACTIVE` templates accept new lead enrollments. If you're building a lead import workflow, filter by `status=ACTIVE` to show only templates available for enrolment.
</Tip>