BatchUpsertContactsRequest

Request body for batch upserting contacts.

  • items
    Type: array object[] · BatchUpsertItem[] …100
    required

    Items to upsert. Maximum 100 items per batch.

    A single item in a batch upsert request.

    • data
      Type: object · UpsertContactRequest
      required

      Contact data to create or update.

    • externalId
      Type: string
      max length:  
      255
      required

      External ID within the namespace.

    • clientRef
      Type: null | string
      max length:  
      100

      Optional client-provided reference for correlation in responses.

  • namespace
    Type: string
    max length:  
    50
    required

    External system namespace (e.g. "hubspot", "salesforce"). Applied to all items in the batch.

  • match
    Type: null | string
    max length:  
    20

    Optional email match fallback. Set to "email" to match by email if externalRef not found.

  • revive
    Type: boolean

    Whether to reactivate soft-deleted contacts. Default: true.