Contacts

Batch Contact Related

Sequences and/or lists for up to 100 contacts in ONE request. Writes nothing.

Use this instead of looping GET /contacts/{contact_id}/sequences or /lists per contact: the loop spends one rate-limit slot per contact and hits 429 on a large book; this spends one per 100.

Each contact gets exactly what its per-contact route returns, through the same access check. A contact that does not exist or is outside the key's scope for any requested include comes back found: false with no related records, rather than failing the batch. POST only because the ids are a body; it is tiered as a read.

post/contacts/related

Request

  • Base URL: https://be.graph8.com/api/v1
  • URL: https://be.graph8.com/api/v1/contacts/related
  • Auth: HTTP bearer

Headers

Authorizationstring nullable
X-Target-Org-Idstring nullable

Request body

contact_idsinteger[] required

Up to 100 contact ids, the same ids the per-contact routes take. Duplicates are read once; the response keeps first-seen order.

includestring[]

Related records to return per contact. sequences matches GET /contacts/{contact_id}/sequences; lists matches GET /contacts/{contact_id}/lists (keyed on the contact primary key).

Response

Successful Response

Changes

No recorded changes to this operation across all 2 revisions of this API.