Deliveries

Bulk deliver multiple audiences

Accepts a list of audience IDs and shared delivery parameters. Fires N parallel delivery jobs and returns per-audience results as HTTP 207 Multi-Status. Partial failure is acceptable — failed items do not roll back succeeded ones. Download is the currently active destination; LiveRamp and Narrative return 503 before any item or billable record is created. An item whose audience count is unknown and cannot be computed fails with code AUDIENCE_COUNT_UNAVAILABLE. Requires 'creator' scope.

post/v1/deliveries/bulk

Request

  • Base URL: https://api.infiniteaudience.ai
  • URL: https://api.infiniteaudience.ai/v1/deliveries/bulk
  • Auth: HTTP bearer

Request body

audience_idsstring[] required

IDs of audiences to deliver. Max 25 per request.

destination'download' | 'liveramp' | 'narrative' required

Shared destination. liveramp and narrative currently return DELIVERY_DESTINATION_UNAVAILABLE without billing.

template_idstring nullable

Attribute template ID applied to every audience in the batch. standard_iag is valid; standard_enrichment is valid for pure matched exports and matching. Mutually exclusive with field_list. If neither is provided, the enrichment set is used for pure matched output; otherwise the audience set is used.

field_liststring[] nullable

Explicit attribute list applied to every audience in the batch — every attribute must be a field allowed for that audience. Mutually exclusive with template_id. If neither is provided, the enrichment set is used for pure matched output; otherwise the audience set is used.

output_format'csv' | 'avro' | 'json' | 'jsonl'

Shared download artifact format for the batch.

output_compression'none' | 'gzip'

Shared artifact compression. gzip is supported for csv/json/jsonl; Avro uses native DEFLATE and rejects gzip.

session_idstring nullable

Chat session ID for push notification routing.

campaign_idstring nullable

Campaign context for notification routing.

Response

Multi-Status — per-audience results. Each entry contains audience_id, delivery_id (if created), status, and error (if failed). Billing capacity errors also expose the same machine-readable code and USD-denominated capacity details as the single-audience delivery endpoint.

Changes

No recorded changes to this operation across all 1 revision of this API.