contacts

Batch Create Contact Entries

Changed on

Add entries to existing contact lists in batch (up to 100 items per request).

Unlike single-resource POST endpoints, the body wraps the payloads in items and the response reports a per-item status. Every entry is linked to a contact in the request, so contact_id is always set: an existing contact of the workspace matched by email or LinkedIn URL, or a new one. An item whose contact is already in the list is reported as ALREADY_MEMBER and counts as succeeded.

Requires the contact_lists:write scope on the API key.

post/v1/contact-entries

Request

  • Base URL: https://api.topo.io
  • URL: https://api.topo.io/v1/contact-entries
  • Auth: HTTP bearer

Request body

Response

Successful Response

Changes

  • 889b0290212fRevision changes
    • warning

      added the new ALREADY_MEMBER enum value to the // response property for the response status

  • b390cd1c4e2aRevision changes
    • info

      added the new optional request property //

    • info

      added the required property //// to the response with the status