Skip to main content
POST
/
v3
/
sequences
/
{id}
/
contacts
/
set-bounced
Mark or unmark contacts as bounced in this sequence
curl --request POST \
  --url https://api.reply.io/v3/sequences/{id}/contacts/set-bounced \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "contactIds": [
    123
  ],
  "isBounced": true,
  "resendEmails": true
}
'
{}

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

Body

application/json
​
contactIds
integer[]
required

Contact IDs to update. At least one, at most 100. Each ID must be positive.

Required array length: 1 - 100 elements
​
isBounced
boolean
required

true marks the contacts as bounced; false clears the bounced flag.

​
resendEmails
boolean | null

Required (non-null) when isBounced=false; must be omitted when isBounced=true. When true, the previously bounced step is rescheduled for retry.

Response

Non-atomic result. The response body is a dictionary keyed by contact id listing per-item failures. Empty object {} means all contacts were updated successfully.

Per-item failures use the SequenceContactError enum. Common per-item slugs:

SlugMeaning
invalidInputGeneric validation failure for this contact
contactNotFoundContact does not exist
notInSequenceContact is not in this sequence
forbiddenCaller lacks permission for this contact

Dictionary of per-item failures keyed by contact id. Empty object {} means all succeeded.

​
{key}
NotProcessedItemResult · object

Per-item error for non-atomic bulk operations. Only failed items are returned in the response dictionary. Items not present in the dictionary succeeded.