Skip to main content
POST
/
v3
/
sequences
/
{id}
/
steps
/
{step_id}
/
variants
Create a step variant
curl --request POST \
  --url https://api.reply.io/v3/sequences/{id}/steps/{step_id}/variants \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "subject": "Follow up on our conversation",
  "message": "Hi {{firstName}}, I wanted to follow up...",
  "isEnabled": true,
  "attachmentIds": [
    101,
    102
  ]
}
'
{
  "id": 1,
  "subject": "Follow up on our conversation",
  "message": "Hi {{firstName}}, I wanted to follow up...",
  "isEnabled": true,
  "hasAttachments": false
}

Documentation Index

Fetch the complete documentation index at: https://docs.reply.io/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Authorization
string
header
required

Authenticate every request with a Bearer token. Pass your Reply API key in the Authorization header:

Authorization: Bearer <your-api-key>

Get your API key from the Reply dashboard: Settings → API Key.

Path Parameters

​
id
integer
required

Sequence Id

​
step_id
integer
required

Step Id

Body

application/json

Request body for creating or updating a text variant

​
message
string
required

Message content of the variant

​
subject
string | null

Subject line of the variant

​
isEnabled
boolean
default:true

Whether the variant is enabled

​
attachmentIds
integer[] | null

IDs of previously uploaded attachments to attach to this variant. Upload files via POST /v3/attachments first to obtain attachment IDs. A variant may carry up to 3 attachments. Omit or pass null to leave attachments unchanged on update; pass an empty array to clear existing attachments.

Maximum array length: 3

Response

Variant created successfully

A text variant for a sequence step

​
id
integer
read-only

Unique identifier for the variant

​
subject
string | null

Subject line of the variant

​
message
string | null

Message content of the variant

​
isEnabled
boolean

Whether the variant is enabled

​
hasAttachments
boolean

Whether the variant has any attachments. To retrieve or modify attachments, use GET /v3/attachments and the attachmentIds field on create/update.