Skip to main content
An Audience represents a customer list uploaded to Whop for ad targeting. Audiences belong to an account and sync to supported ad platforms as custom audiences. Use the Audiences API to create audiences from CSV uploads, monitor processing status, and list or delete audiences for an account. Created audiences are usable for targeting after processing reaches ready or partial.

​
Endpoints

​
Attributes

​
string
required
Audience ID, prefixed adaud_.
​
string
required
custom = a customer list (uploaded, or built from saved People filters); lookalike = Meta lookalike built from a custom audience.Available options: custom, lookalike
​
boolean
required
Whether membership keeps updating. true rebuilds it from the saved filters twice a day, so people join and leave as they start and stop matching. false keeps whoever matched when it was built and never rebuilds. Always false for uploaded lists and lookalikes.
​
string
required
When the audience was created, as an ISO 8601 timestamp.
​
string | null
required
Processing error message. null unless processing is partial or failed.
​
object | null
required
For audiences built from People filters: the filters that define membership, keyed exactly as GET /people accepts them — for example \{"os": "iOS", "country": "US"}. null for uploaded lists and lookalikes.
​
string | null
required
When the audience membership was last rebuilt, as an ISO 8601 timestamp. null until the first build completes.
​
number | null
required
For lookalikes: the upper bound of the similarity band as a fraction (0.02 = top 2%). null for custom audiences.
​
number | null
required
For lookalikes: the lower bound of the similarity band as a fraction. null for custom audiences and first-tier lookalikes.
​
object[]
required
Estimated match rates by ad platform. Empty when the audience was not sent to a supported platform.

Properties

​
number | null
required
Lower bound of the estimated match rate percentage. null until available.
​
string
required
The ad platform that provided the match-rate estimate.Available options: meta
​
string | null
required
Availability of the estimated match rate.Available options: calculating, available, unavailable
​
number | null
required
Upper bound of the estimated match rate percentage. null until available.
​
number
required
Members successfully uploaded to connected ad accounts. Always 0 for lookalikes.
​
string
required
Audience display name.
​
string[]
required
External audience IDs created on connected ad platforms, such as Meta.
​
number
required
Members processed from the source so far. Always 0 for lookalikes.
​
number
required
Processing progress from 0 to 100.
​
string | null
required
For lookalikes: the audience this lookalike was built from. null for custom audiences.
​
string
required
Where members come from. csv_upload = an uploaded customer list; people_filter = built from saved People filters. See auto_refresh for whether a people_filter audience keeps updating.Available options: csv_upload, people_filter
​
string
required
Current state of the audience import. syncing means Whop is sending matched rows to connected ad accounts. When status is partial or failed, error_message explains what went wrong.Available options: pending, processing, syncing, ready, partial, failed
​
number
required
Total members detected in the source — CSV rows for uploaded lists, matching people for automatic audiences. Always 0 for lookalikes.
​
string
required
When the audience was last updated, as an ISO 8601 timestamp.
Audience