Contacts (v2)
Delete Contact
Unsubscribe a contact from a sending list by setting their subscription status to inactive.
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
Next Steps
Importing Contacts
Manage your contact data
Create Audience
Segment your contacts