---
title: "Start live sequence test"
method: POST
path: "/sequences/{sequenceId}/test-runs"
tags: ["Sequences"]
---

# Start live sequence test

`POST /sequences/{sequenceId}/test-runs`

Runs real sequence actions for one active subscriber. Emails are marked as tests. Requires sequences:activate and subscribers:read. Does not enable the sequence or record a trigger event. Ordinary failure retries are disabled; stalled-job recovery can replay actions after worker loss. Completed side effects are not rolled back. Inspect before starting another run.

## Path parameters

- `sequenceId` string, required

## Request body

- object
  - `subscriberId` string, required — Active subscriber in the same company with an email address.
  - `speedMultiplier` integer — Delay acceleration. Existing live-test wait caps still apply.
  - `customVariables` object — Trigger event properties available as event.* in sequence actions. Supports nested objects and arrays. Omit or use an empty object for no event properties. Null is invalid. No event is recorded and subscriber attributes are not changed by supplying this object.

## Response `200`

Sequence test run.

- SequenceTestRunResponse
  - `run` object, required
    - `id` string, required — Test run ID.
    - `automationId` string, required — Sequence ID.
    - `companyId` string, required
    - `subscriberId` string, nullable, required — Subscriber ID, or null on historical runs.
    - `initiatedByUserId` string, nullable
    - `status` 'queued' | 'running' | 'completed' | 'failed', required
    - `recipientEmails` string[], required
    - `speedMultiplier` integer, required
    - `steps` object[], required — Step execution logs including nodeId, status, message, timing and action-specific metadata when available.
    - `errorMessage` string, nullable
    - `createdAt` string, date-time, required
    - `updatedAt` string, date-time, required
    - `startedAt` string, date-time, nullable
    - `finishedAt` string, date-time, nullable
    - `jobId` string — Queue job ID on creation only. Empty if unavailable.

## Other responses

- `400` — Invalid request, event properties, speed or subscriber without an email address.
- `401` — Missing or invalid authentication.
- `403` — Missing scopes or restricted company role.
- `404` — Sequence, active subscriber or run not found or not accessible.
- `409` — A test is already queued or running for this subscriber.
- `500` — Failed to queue the test. The created run is marked failed. An enqueue error can have an uncertain outcome; inspect before starting another run.

## Changes

- **2026-09-11** `1938006077ff` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/sequenzy/apis/sequenzy-api/changes/sequences/:sequenceId/test-runs/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/e93563b0d37e?raw)