Sign in
contacts

Bulk-update contacts (v2)

Update multiple contacts in a single request. Per-row results are settled (some can succeed, others fail). Requires Idempotency-Key. Returns { data: { affected, ids } } where ids lists the contact IDs that were successfully updated.

post/v2/contacts/batch-update

Headers

Idempotency-Keystring required
Example:01HV8N6X7K3P9Q5R2T4Y6W8Z0A

Required. UUID per logical operation, reused on every retry. See apps/rest-api/src/shared/idempotency.ts for the full contract. Missing → 400 BadRequest; same key + different body → 409 Conflict.

Request body

Response

Successful response

Changes

Changed in 5 of the 17 revisions of this API.194

  • a2f71a2438391See the full diff
    • ○

      api operation id batchUpdateContactsV2 was added

      api-operation-id-added

  • b387e63b4b908See the full diff
    • ●

      the updates/items/data/contact_emails/items/email request property's maxLength was set to 320

      request-property-max-length-set

    • ●

      the updates/items/data/contact_phone_numbers/items/phone_number request property's maxLength was set to 50

      request-property-max-length-set

    • ●

      the updates/items/data/contact_phone_numbers/items/phone_number_sanitized/anyOf[subschema #1]/ request property's maxLength was set to 50

      request-property-max-length-set

    • ●

      the updates/items/data/linkedin_last_message_snippet/anyOf[subschema #1]/ request property's maxLength was set to 500

      request-property-max-length-set

    • ●

      the updates/items/data/coordinates/data/latitude request property's max was set to 90.00

      request-property-max-set

    • ●

      the updates/items/data/coordinates/data/longitude request property's max was set to 180.00

      request-property-max-set

    • ●

      the updates/items/data/coordinates/data/latitude request property's min was set to -90.00

      request-property-min-set

    • ●

      the updates/items/data/coordinates/data/longitude request property's min was set to -180.00

      request-property-min-set

  • 6f01cd52ac1211See the full diff
    • ●

      removed the request property updates/items/data/created_at

      request-property-removed

    • ○

      added the new optional request property updates/items/data/first_met_at

      new-optional-request-property

  • bb07f694354611See the full diff
    • ▲

      removed subschema #1 subschema #2 from the updates/items/data/related_contacts/anyOf[subschema #1]/remove/items/ request property anyOf list

      request-property-any-of-removed

    • ○

      added subschema #1 subschema #2 to the updates/items/data/related_contacts/anyOf[subschema #1]/remove/items/ request property anyOf list

      request-property-any-of-added

  • 07a79f0ff8791See the full diff
    • ○

      added the new optional request property updates/items/data/created_at

      new-optional-request-property