Start Live Sequence Test

POST

api

sequences

{sequenceId}

test-runs

Start Live Sequence Test

curl --request POST \
  --url https://api.sequenzy.com/api/v1/sequences/{sequenceId}/test-runs \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://api.sequenzy.com/api/v1/sequences/{sequenceId}/test-runs"

headers = {"Authorization": "Bearer <token>"}

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

print(response.text)

const options = {method: 'POST', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.sequenzy.com/api/v1/sequences/{sequenceId}/test-runs', 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}/test-runs",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

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

curl_close($curl);

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

package main

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

func main() {

	url := "https://api.sequenzy.com/api/v1/sequences/{sequenceId}/test-runs"

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

	req.Header.Add("Authorization", "Bearer <token>")

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

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

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.sequenzy.com/api/v1/sequences/{sequenceId}/test-runs")

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

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'

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

Run your saved sequence for one active subscriber with an email address. This performs real actions, including webhooks, subscriber updates and discounts. Emails are marked as tests. It does not enable the sequence or record a trigger event. Requires sequences:activate and subscribers:read. Pass subscriberId and optionally speedMultiplier (integer from 60 to 10000, default 120). Existing live-test delay and wait caps apply. Supply customVariables as the event properties object, without an outer event wrapper:

{
  "subscriberId": "sub_123",
  "customVariables": {
    "cart_id": "cart_123",
    "event_ids": ["event_1", "event_2"],
    "cart": { "total": 49.5 }
  }
}

Your sequence can reference {{event.cart_id}} and nested values such as {{event.cart.total}}. Arrays remain arrays. Omit customVariables or pass {} for no event properties; null, scalar roots and array roots are invalid. Supplying properties does not itself update subscriber attributes. These values belong to this run and are not saved as sequence configuration. The run response has no separate event-properties field, but resolved values can appear in step logs. The response contains run, with id, automationId, companyId, subscriberId, initiatedByUserId, recipientEmails, speedMultiplier, status, steps, errorMessage, createdAt, updatedAt, startedAt, finishedAt and a creation-only jobId. Initial status is queued, steps are empty and start/finish/error fields are null. Poll Get Live Sequence Test using run.id. Invalid input returns 400; missing authentication returns 401; missing scopes or restricted roles return 403. Inaccessible sequences or active subscribers return 404. An existing queued/running test for the same sequence and subscriber returns 409. Queue failure returns 500 and marks the run failed. Ordinary failure retries are disabled. Stalled-job recovery can replay actions after worker loss. A failed run can have completed real actions, which are not rolled back. Inspect its steps before starting a new run; repeating a run can repeat emails, webhooks and other actions.

sequenzy sequences test-run seq_123 --subscriber sub_123 --event-properties '{"cart_id":"cart_123","event_ids":["event_1","event_2"]}' --json
sequenzy sequences test-run-get seq_123 run_123 --json

MCP provides start_sequence_test_run with the same request fields and get_sequence_test_run with sequenceId and runId. Use Send Sequence Step Test for a single email or Simulate Sequence for a dry run.

Start Live Sequence Test

curl --request POST \
  --url https://api.sequenzy.com/api/v1/sequences/{sequenceId}/test-runs \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://api.sequenzy.com/api/v1/sequences/{sequenceId}/test-runs"

headers = {"Authorization": "Bearer <token>"}

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

print(response.text)

const options = {method: 'POST', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.sequenzy.com/api/v1/sequences/{sequenceId}/test-runs', 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}/test-runs",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

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

curl_close($curl);

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

package main

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

func main() {

	url := "https://api.sequenzy.com/api/v1/sequences/{sequenceId}/test-runs"

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

	req.Header.Add("Authorization", "Bearer <token>")

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

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

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.sequenzy.com/api/v1/sequences/{sequenceId}/test-runs")

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

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'

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