Skip to main content
POST
/
v3
/
sequences
/
{id}
/
steps
/
{step_id}
/
variants
/
bulk
Bulk create step variants
curl --request POST \
  --url https://api.reply.io/v3/sequences/{id}/steps/{step_id}/variants/bulk \
  --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": 123,
    "error": 123,
    "errorDetails": "<string>"
  }
]

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
​
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

Array of per-item results, one per input variant (same order as request).

Possible per-item error codes:

Error codeMeaning
invalidInputValidation failed (e.g. more than 3 attachments)
invalidStepStep type does not support this variant
forbiddenOne or more attachment IDs are not accessible to the caller
internalErrorUnexpected server error
​
id
integer | null
read-only

ID of the created resource, null if creation failed

​
error
integer | null
read-only

Error code if creation failed

​
errorDetails
string | null
read-only

Human-readable error description if creation failed