Update contact list subscription status

Updates the subscription status of a contact in a specific list. Can set status to active, pending, unsubscribed, bounced, or complained.

post/api/contactLists.updateStatus

Request body

workspace_idstring required

The ID of the workspace

emailstring email required

Email address of the contact

list_idstring required

ID of the list

status'active' | 'pending' | 'unsubscribed' | 'bounced' | 'complained' required

New subscription status

{
  "workspace_id": "ws_1234567890",
  "email": "user@example.com",
  "list_id": "newsletter",
  "status": "active"
}

Status updated successfully

successboolean

Whether the operation was successful

messagestring

Status message

foundboolean

Whether the contact was found in the list

{
  "success": true,
  "message": "status updated successfully",
  "found": true
}