# Frontline Audiences API

**Canonical:** https://apis.io/apis/frontline/frontline-audiences-api/  
**Provider:** Frontline — https://apis.io/providers/frontline/  
**Base URL:** https://prod-api.getfrontline.ai  
**Documentation:** https://docs.getfrontline.ai/reference/openapi

Frontline Audiences API is one of 57 APIs that [Frontline](https://apis.io/providers/frontline/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Audiences. The published artifact set on APIs.io includes an OpenAPI specification.

Create and manage campaign audiences

## Operations (23)

| Method | Path | Summary |
|---|---|---|
| GET | `/public/v1/audience-drafts` | List audience drafts owned by the API user |
| POST | `/public/v1/audience-drafts` | Create an audience draft |
| GET | `/public/v1/audience-drafts/{audienceId}` | Get an audience draft |
| PATCH | `/public/v1/audience-drafts/{audienceId}` | Update an audience draft |
| DELETE | `/public/v1/audience-drafts/{audienceId}` | Discard an audience draft |
| POST | `/public/v1/audience-drafts/{audienceId}/import-batches` | Create a streaming CSV import batch |
| GET | `/public/v1/audiences/{audienceId}/imports/{importId}/errors` | Download rejected audience import rows |
| PUT | `/public/v1/audience-drafts/{audienceId}/import-batches/{batchId}/imports/{importId}/file` | Stream one CSV file into a private import |
| POST | `/public/v1/audience-drafts/{audienceId}/import-batches/{batchId}/confirm` | Confirm and enqueue an uploaded audience import batch |
| GET | `/public/v1/audience-drafts/{audienceId}/import-batches/{batchId}` | Get an audience draft import batch |
| DELETE | `/public/v1/audience-drafts/{audienceId}/import-batches/{batchId}` | Delete a stopped audience draft import batch |
| POST | `/public/v1/audience-drafts/{audienceId}/import-batches/{batchId}/retry` | Retry a failed audience draft import batch |
| POST | `/public/v1/audience-drafts/{audienceId}/publish` | Publish an audience draft |
| GET | `/public/v1/audiences` | List audiences |
| POST | `/public/v1/audiences` | Create an audience |
| GET | `/public/v1/audiences/{audienceId}` | Get an audience |
| PATCH | `/public/v1/audiences/{audienceId}` | Update an audience |
| DELETE | `/public/v1/audiences/{audienceId}` | Archive an audience |
| GET | `/public/v1/audiences/{audienceId}/preview` | Preview audience members |
| GET | `/public/v1/audiences/{audienceId}/history` | List audience edit history |
| POST | `/public/v1/audiences/{audienceId}/import` | Import CSV rows into an audience |
| GET | `/public/v1/audiences/{audienceId}/imports/{importId}` | Get audience import status |
| POST | `/public/v1/audiences/{audienceId}/exports` | Download an audience export |

## Machine-readable artifacts (1)

- **OpenAPI** — https://artifacts.apis.io/frontline/openapi/frontline-audiences-api-openapi.yml

## Other Frontline APIs (12)

- [Frontline Account API](https://apis.io/apis/frontline/frontline-account-api/)
- [Frontline Agent Builder API](https://apis.io/apis/frontline/frontline-agent-builder-api/)
- [Frontline Agents API](https://apis.io/apis/frontline/frontline-agents-api/)
- [Frontline AI Models API](https://apis.io/apis/frontline/frontline-ai-models-api/)
- [Frontline Billing API](https://apis.io/apis/frontline/frontline-billing-api/)
- [Frontline Flow Variables API](https://apis.io/apis/frontline/frontline-flow-variables-api/)
- [Frontline Flows API](https://apis.io/apis/frontline/frontline-flows-api/)
- [Frontline Incoming Webhooks API](https://apis.io/apis/frontline/frontline-incoming-webhooks-api/)
- [Frontline Intents API](https://apis.io/apis/frontline/frontline-intents-api/)
- [Frontline Object activities API](https://apis.io/apis/frontline/frontline-object-activities-api/)
- [Frontline Object aggregations API](https://apis.io/apis/frontline/frontline-object-aggregations-api/)
- [Frontline Object export API](https://apis.io/apis/frontline/frontline-object-export-api/)

## Tags

Audiences

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/frontline/frontline-audiences-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/frontline/.