Delete multiple contacts

DELETE

/contacts/bulk

Deletes up to 100 contacts per request. Each item identifies a contact by contactId, clientContactId, email, or phoneNumber1. Note: unlike bulk upsert (which matches on clientContactId, email, phoneNumber1), bulk delete also accepts the internal contactId.

Always returns 207. Inspect the per-item status field to determine the outcome for each contact.

Request

Header Params

Body Params application/json

Examples

Responses

🟠400

application/json

Bad Request

Bodyapplication/json

🟠403

Request Example

Shell

JavaScript

Java

Swift

curl --location --request DELETE '/contacts/bulk' \
--header 'Authorization: Bearer JWT' \
--header 'Content-Type: application/json' \
--data-raw '{
    "contacts": [
        {
            "contactId": "760819d3-92bb-420c-967a-77f693dfc5d3"
        },
        {
            "clientContactId": "1245451254"
        },
        {
            "email": "info@incomaker.com"
        }
    ]
}'

Response Example

400 - Success

{
    "error": "Request exceeds maximum of 100 contacts per bulk operation."
}

Modified at 2026-06-17 16:24:00

Upsert multiple contacts

Contact login