Create audience

post

https://apiv3.delivr.ai/api/v1/audiences

Create a new audience with the specified type and parameters.

Type-specific requirements:

events: Requires filter with filter rules for pixel event data.
intents: Requires filter with topic-based intent criteria.
elixir: Requires filter with Elixir dataset criteria.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

audience_name

string

required

Audience name.

audience_description

string

Description of the audience.

type

string

enum

required

Audience type.

Allowed:

segmentation_type

string

enum

required

Segmentation type.

Allowed:

organization_id

uuid

required

Organization ID.

project_id

uuid

required

Project ID.

filter

object

required

A group of filter rules joined by a logical operator. Groups can be nested to create complex expressions (e.g., AND of ORs).

select

string

Column projection clause.

unload

string

enum

preview to get a size estimate, unload to write output files.

Allowed:

renew_frequency

string

enum

Schedule for automatic refresh.

daily: refreshes every day at 09:00 UTC.
weekly: refreshes every Saturday at 18:00 UTC (weekend afternoon UTC, so the weekly batch doesn't compete with daily intent refreshes at 09:00 UTC).
manual: no automatic refresh; the audience only refreshes when a caller hits POST /audiences/{id}/refresh or re-runs an unload manually.

When omitted, the default depends on type:

intents: defaults to daily (intent data is produced fresh every day).
elixir: defaults to weekly (Elixir source data refreshes weekly/monthly; daily renewal would re-run unloads against unchanged data).

Customers who really want daily refresh on an elixir audience can opt in by passing daily explicitly.

Allowed:

intent_window_days

integer

1 to 14

Number of recent days of intent data to include (1-14). Only applicable to intents audiences. Default: 1.

status

string

Initial status.

Responses

401

Missing or invalid authentication.

403

Forbidden.

500

Internal server error.

201Audience created.

400Invalid request body.