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

​
id
string
required
Audience ID, prefixed adaud_.
​
audience_type
string
required
custom = uploaded customer list; lookalike = Meta lookalike built from a custom audience.Available options: custom, lookalike
​
created_at
string
required
When the audience was created, as an ISO 8601 timestamp.
​
error_message
string | null
required
Processing error message. null unless processing is partial or failed.
​
lookalike_ratio
number | null
required
For lookalikes: the upper bound of the similarity band as a fraction (0.02 = top 2%). null for custom audiences.
​
lookalike_starting_ratio
number | null
required
For lookalikes: the lower bound of the similarity band as a fraction. null for custom audiences and first-tier lookalikes.
​
match_rates
object[]
required
Estimated match rates by ad platform. Empty when the audience was not sent to a supported platform.

Properties

​
lower_bound
number | null
required
Lower bound of the estimated match rate percentage. null until available.
​
platform
string
required
The ad platform that provided the match-rate estimate.Available options: meta
​
status
string | null
required
Availability of the estimated match rate.Available options: calculating, available, unavailable
​
upper_bound
number | null
required
Upper bound of the estimated match rate percentage. null until available.
​
matched_rows
number
required
Rows successfully uploaded to connected ad accounts. Always 0 for lookalikes.
​
name
string
required
Audience display name.
​
platform_audience_ids
string[]
required
External audience IDs created on connected ad platforms, such as Meta.
​
processed_rows
number
required
Rows processed from the uploaded CSV. Always 0 for lookalikes.
​
progress_percent
number
required
Processing progress from 0 to 100.
​
source_audience_id
string | null
required
For lookalikes: the audience this lookalike was built from. null for custom audiences.
​
status
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
​
total_rows
number
required
Total rows detected in the uploaded CSV. Always 0 for lookalikes.
​
updated_at
string
required
When the audience was last updated, as an ISO 8601 timestamp.
Audience