Lists

Add Deals To List

Put deals on a deals list.

Each deal is checked against the caller's DEAL scope as well as the list's, so adding a deal you cannot see is refused rather than silently skipped.

post/lists/{audience_id}/deals

Request

  • Base URL: https://be.graph8.com/api/v1
  • URL: https://be.graph8.com/api/v1/lists/{audience_id}/deals
  • Auth: HTTP bearer

Path parameters

audience_idinteger required

List (audience) id.

Headers

Authorizationstring nullable
X-Target-Org-Idstring nullable

Request body

deal_idsstring[] required

Deal ids (strings, unlike the others).

sourcestring nullable

Where the addition came from, for the audit trail.

Response

Successful Response

dataListPayload required

An open envelope for a list, a capability map or a job result.

Open because several of these return the whole Audience, whose shape carries per-source metadata that differs between an uploaded file, a dynamic query and a master list - and grows with them.

Changes

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