Skip to main content

Remove Suppressed Contacts

POST 

/v1/suppression/remove

Remove contacts from your suppression list. Provide the same identifiers that were used when adding the contacts.

Request Body

FieldTypeDescriptionRequired
contactsarrayArray of contact objects to remove from suppression✅ Yes

Contact Object Fields

FieldTypeDescriptionRequired
emailstringEmail address to remove❌ No
phone_numberstringPhone number to remove❌ No
linkedin_urlstringLinkedIn URL to remove❌ No

Note: At least one identifier must be provided per contact.


Example Request (JSON)

{
"contacts": [
{
"email": "donotcontact@example.com"
}
]
}


Response

The response returns the number of contacts successfully removed.

Example Success Response

{
"removed_count": 1
}


Error Handling

The API returns appropriate error messages with status codes if something goes wrong.

Error CodeMessageDescription
400Invalid RequestVerify your request is properly formatted
401UnauthorizedVerify you are using a valid API key
500Internal Server ErrorAn unexpected error occurred.

Request

Responses

Successful response