Upsert multiple contacts

PUT

/contacts/bulk

Creates or updates up to 100 contacts per request. Each contact is matched automatically using the identifiers present in the contact object, checked in priority order: clientContactId → email → phoneNumber1. Matched contacts are updated (PATCH semantics — only provided fields are changed). Contacts with no match are created as new records. If you need larger volumes of contacts, use asynchronous bulk endpoint.

You cannot use event or permId in bulk operations.

Always returns 207. Inspect the per-item status field to determine the outcome for each contact. The response includes all submitted contacts so that callers can store the Incomaker contactId for future targeted updates.

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 PUT '/contacts/bulk' \
--header 'Authorization: Bearer JWT' \
--header 'Content-Type: application/json' \
--data-raw '{
    "contacts": [
        {
            "clientContactId": "1245451254",
            "firstName": "John",
            "lastName": "Doe",
            "email": "info@incomaker.com",
            "phoneNumber1": "87639642",
            "company": "Incomaker s.r.o.",
            "lists": [
                "Test",
                "Test2"
            ]
        },
        {
            "clientContactId": "1245451278",
            "firstName": "Jane",
            "lastName": "Doe",
            "email": "jane@incomaker.com",
            "phoneNumber1": "12121545",
            "lists": [
                "Test2"
            ]
        }
    ]
}'

Response Example

400 - Success

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

Modified at 2026-06-11 02:37:32

Get total number of contacts

Delete multiple contacts