Reply icon

Reply

Interact with Reply.io API

Actions15

Contact Status → Update Status

AI-generated

Summary

Sets a specific status on a Reply.io contact, applicable across all sequences or restricted to a single sequence.

Inputs

  • contactLocator (required) — The contact to update, specified by ID, Email, or LinkedIn URL.
  • status (required) — The status to set. Options include Active, Bounced, Called, Finished, MeetingBooked, OptedOut, OutOfOffice, Paused, Replied, and ToCall.
  • additionalFields — Optional collection to restrict the status change to a specific sequence by ID, Name, or from a list. Ignored for global statuses like OptedOut, Called, ToCall, and MeetingBooked.

Output shape

The API's response for the update operation. If the API returns an empty body, a success summary is returned containing the contactId, status, and optionally the sequenceId.

The 'additionalFields.sequenceId' parameter is ignored for OptedOut, Called, ToCall, and MeetingBooked, which are global per-contact flags.

Examples

Example 1: Mark a contact as Replied in a specific sequence

ContactLocator (Email), Status (Replied), Additional Fields (SequenceId: By Name)

Example 2: Opt out a contact globally

ContactLocator (ID), Status (OptedOut), Additional Fields (Empty)

Example 3: Pause a contact in all sequences

ContactLocator (LinkedIn), Status (Paused), Additional Fields (Empty)

Links

Discussion