Upsert multiple contacts (async)

POST

/contacts/bulk/async

Enqueues a contacts.import background job instead of processing synchronously. Unlike PUT /contacts/bulk (capped at 100, processed inline), this has no item cap and is intended for full-catalog-sized syncs. Track progress via GET /jobs/{jobId} and per-item outcomes via GET /jobs/{jobId}/items.

Request

Header Params

Body Params application/json

Examples

Responses

🟢202Accepted

application/json

Bodyapplication/json

🟠400Bad request

🔴500Internal error

Request Example

Shell

JavaScript

Java

Swift

curl --location '/contacts/bulk/async' \
--header 'Idempotency-Key;' \
--header 'Authorization: Bearer JWT' \
--header 'Content-Type: application/json' \
--data-raw '{
    "contacts": [
        {
            "clientContactId": "1245451254",
            "firstName": "John",
            "lastName": "Doe",
            "titleBefore": "Prof.",
            "titleAfter": "Ph.D.",
            "formalSalutation": "Dear Mr. Doe",
            "informalSalutation": "Dear John",
            "company": "Incomaker s.r.o.",
            "position": "CEO",
            "personalId": "75876549203",
            "consentDate": "2018-05-30T13:00:00+02:00",
            "contactSource": "Pop-up",
            "clientContactCreated": "2018-05-30T13:00:00+02:00",
            "email": "info@incomaker.com",
            "phoneNumber1": "87639642",
            "phoneNumber2": "76590824502",
            "street": "Argentinska",
            "street2": "38",
            "city": "Praha",
            "postalCode": "17000",
            "region": "Praha",
            "country": "CZ",
            "language": "cs",
            "birthday": "2018-05-30",
            "location": {
                "latitude": 50.082034,
                "longitude": 14.40085
            },
            "pricelist": "End user",
            "remarks": "Nothing special for this contact",
            "tags": [
                null
            ],
            "fields": [
                {
                    "name": "importance",
                    "value": "high",
                    "group": "Parameters"
                }
            ],
            "lists": [
                null
            ],
            "listIds": [
                0
            ]
        }
    ]
}'

Response Example

202 - Example 1

{
    "jobId": "string",
    "type": "contacts.import",
    "status": "queued",
    "progress": {
        "total": 0,
        "processed": 0,
        "succeeded": 0,
        "failed": 0
    },
    "createdAt": "2019-08-24T14:15:22.123Z",
    "startedAt": "2019-08-24T14:15:22.123Z",
    "finishedAt": "2019-08-24T14:15:22.123Z",
    "expiresAt": "2019-08-24T14:15:22.123Z",
    "error": "string",
    "links": {
        "self": "/v4/jobs/123",
        "items": "/v4/jobs/123/items"
    }
}

Modified at 2026-08-01 08:22:25

Get contact by phoneNumber1

Get contact events