Update a step variant
curl --request PUT \
--url https://api.reply.io/v3/sequences/{id}/steps/{step_id}/variants/{variant_id} \
--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
]
}
'import requests
url = "https://api.reply.io/v3/sequences/{id}/steps/{step_id}/variants/{variant_id}"
payload = {
"subject": "Follow up on our conversation",
"message": "Hi {{FirstName}}, I wanted to follow up...",
"isEnabled": True,
"attachmentIds": [101, 102]
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.put(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PUT',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
subject: 'Follow up on our conversation',
message: 'Hi {{FirstName}}, I wanted to follow up...',
isEnabled: true,
attachmentIds: [101, 102]
})
};
fetch('https://api.reply.io/v3/sequences/{id}/steps/{step_id}/variants/{variant_id}', 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.reply.io/v3/sequences/{id}/steps/{step_id}/variants/{variant_id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PUT",
CURLOPT_POSTFIELDS => json_encode([
'subject' => 'Follow up on our conversation',
'message' => 'Hi {{FirstName}}, I wanted to follow up...',
'isEnabled' => true,
'attachmentIds' => [
101,
102
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.reply.io/v3/sequences/{id}/steps/{step_id}/variants/{variant_id}"
payload := strings.NewReader("{\n \"subject\": \"Follow up on our conversation\",\n \"message\": \"Hi {{FirstName}}, I wanted to follow up...\",\n \"isEnabled\": true,\n \"attachmentIds\": [\n 101,\n 102\n ]\n}")
req, _ := http.NewRequest("PUT", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.put("https://api.reply.io/v3/sequences/{id}/steps/{step_id}/variants/{variant_id}")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"subject\": \"Follow up on our conversation\",\n \"message\": \"Hi {{FirstName}}, I wanted to follow up...\",\n \"isEnabled\": true,\n \"attachmentIds\": [\n 101,\n 102\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.reply.io/v3/sequences/{id}/steps/{step_id}/variants/{variant_id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Put.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"subject\": \"Follow up on our conversation\",\n \"message\": \"Hi {{FirstName}}, I wanted to follow up...\",\n \"isEnabled\": true,\n \"attachmentIds\": [\n 101,\n 102\n ]\n}"
response = http.request(request)
puts response.read_body{
"id": 1,
"letter": "A",
"subject": "Follow up on our conversation",
"message": "Hi {{FirstName}}, I wanted to follow up...",
"isEnabled": true,
"hasAttachments": false
}Sequence Steps
Update a step variant
Requires the
sequences:write scope (or a broader one that includes it).
Change one variant of a step. Text variants use JSON; LinkedIn voice message variants use multipart form data.
A LinkedIn voice message step needs at least one enabled variant, and every enabled variant needs a recording.
PUT
/
v3
/
sequences
/
{id}
/
steps
/
{step_id}
/
variants
/
{variant_id}
Update a step variant
curl --request PUT \
--url https://api.reply.io/v3/sequences/{id}/steps/{step_id}/variants/{variant_id} \
--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
]
}
'import requests
url = "https://api.reply.io/v3/sequences/{id}/steps/{step_id}/variants/{variant_id}"
payload = {
"subject": "Follow up on our conversation",
"message": "Hi {{FirstName}}, I wanted to follow up...",
"isEnabled": True,
"attachmentIds": [101, 102]
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.put(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PUT',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
subject: 'Follow up on our conversation',
message: 'Hi {{FirstName}}, I wanted to follow up...',
isEnabled: true,
attachmentIds: [101, 102]
})
};
fetch('https://api.reply.io/v3/sequences/{id}/steps/{step_id}/variants/{variant_id}', 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.reply.io/v3/sequences/{id}/steps/{step_id}/variants/{variant_id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PUT",
CURLOPT_POSTFIELDS => json_encode([
'subject' => 'Follow up on our conversation',
'message' => 'Hi {{FirstName}}, I wanted to follow up...',
'isEnabled' => true,
'attachmentIds' => [
101,
102
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.reply.io/v3/sequences/{id}/steps/{step_id}/variants/{variant_id}"
payload := strings.NewReader("{\n \"subject\": \"Follow up on our conversation\",\n \"message\": \"Hi {{FirstName}}, I wanted to follow up...\",\n \"isEnabled\": true,\n \"attachmentIds\": [\n 101,\n 102\n ]\n}")
req, _ := http.NewRequest("PUT", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.put("https://api.reply.io/v3/sequences/{id}/steps/{step_id}/variants/{variant_id}")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"subject\": \"Follow up on our conversation\",\n \"message\": \"Hi {{FirstName}}, I wanted to follow up...\",\n \"isEnabled\": true,\n \"attachmentIds\": [\n 101,\n 102\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.reply.io/v3/sequences/{id}/steps/{step_id}/variants/{variant_id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Put.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"subject\": \"Follow up on our conversation\",\n \"message\": \"Hi {{FirstName}}, I wanted to follow up...\",\n \"isEnabled\": true,\n \"attachmentIds\": [\n 101,\n 102\n ]\n}"
response = http.request(request)
puts response.read_body{
"id": 1,
"letter": "A",
"subject": "Follow up on our conversation",
"message": "Hi {{FirstName}}, I wanted to follow up...",
"isEnabled": true,
"hasAttachments": false
}Authorizations
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
Sequence Id
Step Id
Variant Id
Body
application/jsonmultipart/form-data
Request body for creating or updating a text variant
Message content of the variant. Variable names are case-sensitive, for example {{FirstName}}. See GET /v3/email-templates/variables for the full list. In email steps, unknown variables are rejected with 400.
Subject line of the variant. Variable names are case-sensitive, for example {{FirstName}}. See GET /v3/email-templates/variables for the full list. In email steps, unknown variables are rejected with 400.
Whether the variant is enabled
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:
3Response
Variant updated successfully
A text variant for a sequence step
Unique identifier for the variant
Label of the variant as shown in the app: A, B, C, … by the variant's position in id order within the step, disabled variants included. After Z the letters repeat with a number (A1, B1, …). The label is positional, so deleting a variant relabels the variants after it; use id to identify a variant.
Subject line of the variant
Message content of the variant
Whether the variant is enabled
Whether the variant has any attachments. To retrieve or modify attachments, use GET /v3/attachments and the attachmentIds field on create/update. For a LinkedIn voice message step, true when the variant holds a recording.