Preview sequence audience

This page documents the canonical HTTP contract for this endpoint.

This endpoint only previews. Use Enroll sequence leads or Enroll a selected audience for an explicit mutation. Selection syntax and workspace fields are described in the workspace selection catalog.

Path parameters

sequence_idrequired
string
Sequence identifier.

Name	Type	Description
sequence_idrequired	string	Sequence identifier.

Query parameters

limit · optional
integer
Maximum audience rows to return.
offset · optional
integer
Number of audience rows to skip.

Name	Type	Description
limit	integer	Maximum audience rows to return.
offset	integer	Number of audience rows to skip.

Body parameters

leadIdsrequired
array<string>
Lead IDs to evaluate.
researchContext · optional
object
Optional source-table context used to resolve sequence variables.
variableMap · optional
object<string,string>
Optional variable-to-column mapping.

Name	Type	Description
leadIdsrequired	array<string>	Lead IDs to evaluate.
researchContext	object	Optional source-table context used to resolve sequence variables.
variableMap	object<string,string>	Optional variable-to-column mapping.

Errors

Status	Meaning
401	Authentication is missing or invalid.
403	Missing sequences:read.
404	Sequence not found.

Example

bash

curl -X POST "https://app.autotouch.ai/api/sequences/67c4a4f7b4dd8f2d4999f014/audience/preview" \
  -H "Authorization: Bearer $AUTOTOUCH_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"leadIds":["67c4a4f7b4dd8f2d4999f014"],"researchContext":{"source_table_id":"tbl_123","source_table_name":"Target accounts"},"variableMap":{"first_name":"First Name"}}'

Request body

json

{
  "leadIds": [
    "67c4a4f7b4dd8f2d4999f014"
  ],
  "researchContext": {
    "source_table_id": "tbl_123",
    "source_table_name": "Target accounts"
  },
  "variableMap": {
    "first_name": "First Name"
  }
}

Response example

json

{
  "sequence": {
    "id": "67c4a4f7b4dd8f2d4999f014",
    "name": "Outbound"
  },
  "audience": [
    {
      "enrollmentId": "67c4a4f7b4dd8f2d4999f026",
      "leadId": "67c4a4f7b4dd8f2d4999f014",
      "status": "paused",
      "nextRunAt": null,
      "variables": {},
      "missingRequired": [],
      "variableMap": {},
      "researchTableId": null,
      "researchRowId": null,
      "researchContext": null,
      "researchValues": {},
      "aiResearchFavorites": [],
      "lead": {},
      "createdAt": "2026-09-27T16:00:00Z",
      "updatedAt": "2026-09-27T16:00:00Z"
    }
  ],
  "total": 1,
  "limit": 200,
  "offset": 0,
  "meta": {
    "generated_at": "2026-09-27T16:00:00Z",
    "preview": true
  }
}