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

EndpointRequest
List AudiencesGET /audiences
Create AudiencePOST /audiences
Delete AudienceDELETE /audiences/{audience_id}

​
Attributes

​
created_at
number
required
Unix timestamp when the audience was created.
​
error_message
string | null
required
Processing error message. null unless processing is partial or failed.
​
id
string
required
Audience ID, prefixed adaud_.
​
matched_rows
number
required
Rows successfully uploaded to connected ad accounts.
​
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.
​
progress_percent
number
required
Processing progress from 0 to 100.
​
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.
​
updated_at
number
required
Unix timestamp when the audience was last updated.
Audience
{
	"id": "adaud_PastPurchasers123",
	"name": "Past purchasers",
	"status": "ready",
	"total_rows": 2500,
	"processed_rows": 2500,
	"matched_rows": 1830,
	"progress_percent": 100,
	"error_message": null,
	"platform_audience_ids": ["120246230799130686"],
	"created_at": 1764547200,
	"updated_at": 1764550800
}