Add Deals To List
POST /lists/{audience_id}/deals
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.
Authorizations
Parameters
Path Parameters
List (audience) id.
List (audience) id.
Header Parameters
Request Body required
Put deals on a deals list.
Deal ids are STRINGS here while contact, company, suppression and lead ids are integers. That is the app’s own typing and it is mirrored rather than smoothed over: coercing would make a mistyped id a silent miss.
Responses
201
Successful Response
object
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.
object
object
Whether there are more pages
Items per page
Current page number (1-indexed)
Total number of items
422
Validation Error