Audience upload + recipients listing.
Audience upload + recipients listing.
Prerequisites
- A bearer token in the
Authorizationheader. Any endpoint that needs no token says so on its own page. - The id of each record the call targets. Every endpoint page lists the ids it needs.
Errors
| Status | Meaning |
|---|---|
401 | The bearer token is missing, expired or invalid |
403 | The token is valid but the record sits outside your account |
422 | The request failed validation — the response names the fields |
500 | Unexpected server error |
Individual endpoints may return more; each page lists its own.
Endpoints
| Method | Endpoint | Description |
|---|---|---|
POST | Upload audience | Upload an Excel/CSV audience file to a draft bulk-upload campaign, stores it on S3, and dispatches an async job (ProcessCampaignAudienceUpload) to parse and validate the recipients. |
GET | List audiences (recipients) | Get the paginated, searchable, sortable list of audience recipients for a campaign, plus aggregate validation KPIs, a quality summary, and basic campaign info. |