Skip to main content
DELETE
Unsubscribes a contact from the specified sending list. This sets the ListContact’s active status to false with an unsubscribe reason of api. The contact record itself is not deleted — only their subscription to the list is deactivated. This ensures historical data (send counts, click counts, revenue) is preserved for reporting. The endpoint returns a success response even if the contact or list is not found. Check the unsubscribed field to determine whether an actual unsubscribe took place.

Body Parameters

string
required
Contact phone number in E.164 format (e.g., +14155559876).
string
required
Sending list phone number in E.164 format (e.g., +18005551234). Must be a list owned by your account.

Response Fields

boolean
Always true when the request is processed without error.
boolean
true if the contact was found on the list (their status is set to inactive, even if they were already unsubscribed). false only if the contact does not exist, the list does not exist, or the contact is not a member of the list.

Examples

Error Codes

This endpoint does not delete the contact record or their historical data. It only deactivates their subscription to the specified list. To fully remove a contact’s data, use the account dashboard or contact support.

Next Steps

Importing Contacts

Manage your contact data

Create Audience

Segment your contacts