Bulk remove contacts from sequence

curl --request POST \
  --url https://api.reply.io/v3/sequences/{id}/contact-links/bulk-delete \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "contactIds": [
    123
  ]
}
'

import requests

url = "https://api.reply.io/v3/sequences/{id}/contact-links/bulk-delete"

payload = { "contactIds": [123] }
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

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

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({contactIds: [123]})
};

fetch('https://api.reply.io/v3/sequences/{id}/contact-links/bulk-delete', 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}/contact-links/bulk-delete",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'contactIds' => [
        123
    ]
  ]),
  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}/contact-links/bulk-delete"

	payload := strings.NewReader("{\n  \"contactIds\": [\n    123\n  ]\n}")

	req, _ := http.NewRequest("POST", 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.post("https://api.reply.io/v3/sequences/{id}/contact-links/bulk-delete")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"contactIds\": [\n    123\n  ]\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.reply.io/v3/sequences/{id}/contact-links/bulk-delete")

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

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"contactIds\": [\n    123\n  ]\n}"

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

{
  "requested": 123,
  "removed": 123,
  "notFound": 123,
  "notInSequence": 123,
  "removedIds": [
    123
  ]
}

Sequence Contacts

Bulk remove contacts from sequence

Requires the sequences:operate scope (or a broader one that includes it).

Use this endpoint when you need to take several contacts out of a sequence in one call: list them in contactIds, at least one and with no duplicates. Each of them stops progressing through the steps and anything still scheduled for it in this sequence is cancelled, while the contacts themselves stay in your account and their memberships in other sequences are left alone. The response reports how many ids you requested, how many were removed, and removedIds listing exactly which ones came out — ids you sent that were not enrolled simply do not appear there.

POST

sequences

{id}

contact-links

bulk-delete

Bulk remove contacts from sequence

curl --request POST \
  --url https://api.reply.io/v3/sequences/{id}/contact-links/bulk-delete \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "contactIds": [
    123
  ]
}
'

import requests

url = "https://api.reply.io/v3/sequences/{id}/contact-links/bulk-delete"

payload = { "contactIds": [123] }
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

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

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({contactIds: [123]})
};

fetch('https://api.reply.io/v3/sequences/{id}/contact-links/bulk-delete', 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}/contact-links/bulk-delete",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'contactIds' => [
        123
    ]
  ]),
  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}/contact-links/bulk-delete"

	payload := strings.NewReader("{\n  \"contactIds\": [\n    123\n  ]\n}")

	req, _ := http.NewRequest("POST", 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.post("https://api.reply.io/v3/sequences/{id}/contact-links/bulk-delete")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"contactIds\": [\n    123\n  ]\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.reply.io/v3/sequences/{id}/contact-links/bulk-delete")

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

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"contactIds\": [\n    123\n  ]\n}"

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

{
  "requested": 123,
  "removed": 123,
  "notFound": 123,
  "notInSequence": 123,
  "removedIds": [
    123
  ]
}

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

integer

required

Sequence ID

Body

application/json

contactIds

integer[]

required

Response

Contacts removed from sequence

requested

integer

Number of contacts requested for removal

removed

integer

Number of contacts actually removed

notFound

integer

Number of contacts not found

notInSequence

integer

Number of contacts not in the sequence

removedIds

integer[]

IDs of contacts that were removed

Getting started

For AI agents

API Documentation

Schemas

Webhooks

Machine-readable

Bulk remove contacts from sequence

Authorizations

Path Parameters

Body

Response