Add People
Adds users from a new CSV file to an existing uploaded custom audience. The file uses the audience’s saved column mapping, processing happens in the background, and existing audience members remain unchanged.
Authorizations
An Account API key, an App API key, an account access token, an account-scoped user token, or a user OAuth token. Prepend the key or token with Bearer, for example Bearer ***************************. See Auth & API keys for how to get each one.
Headers
A unique key that makes this request safe to retry. See Idempotent requests.
255"d9105228-4a08-46b1-8b91-42fed586d383"
Pins the request to a dated API version.
"2026-11-04-1"
Path Parameters
Audience ID, prefixed adaud_.
Body
The new customer CSV — a file id (file_...) returned by POST /files. Its headers must match the audience's saved column mapping.
"file_xxxxxxxxxxxxxx"
Response
Audience upload accepted.
Whether the audience targets a defined group of people or people similar to an existing audience.
custom, lookalike "lookalike"
Whether Whop rebuilds membership from saved People filters twice a day. When false, People audiences keep the members matched at creation. Always false for uploaded lists, lookalikes, and engagement audiences.
false
When the audience was created, as an ISO 8601 timestamp.
"2026-01-01T12:00:00.000Z"
Why a pending audience hasn't started, or why a partial or failed one isn't fully built. null when there is nothing to report.
"412 of 1,000 rows had no email or phone number, so the list could not be matched."
Saved Whop People filters that define membership, using the same keys as GET /people. null for uploaded lists, engagement audiences, and lookalikes.
Audience ID, prefixed adaud_.
"adaud_xxxxxxxxxxxxxx"
When the audience membership was last rebuilt, as an ISO 8601 timestamp. null until the first build completes.
"2026-01-01T12:00:00.000Z"
For lookalikes: the upper bound of the similarity band as a fraction (0.02 = top 2%). null for custom audiences.
0.04
For lookalikes: the lower bound of the similarity band as a fraction. null for custom audiences and first-tier lookalikes.
0.02
Members successfully uploaded to connected ad accounts. Always 0 for lookalikes and engagement audiences.
0
Audience display name.
"Past purchasers Lookalike 2–4%"
Audience IDs on the ad networks Whop sends this audience to.
Members processed from the source so far. Always 0 for lookalikes and engagement audiences.
0
Processing progress from 0 to 100.
0
For lookalikes: the audience this lookalike was built from. null for custom audiences.
"adaud_xxxxxxxxxxxxxx"
Membership source: an uploaded CSV, Whop People filters, or social engagement. Engagement audiences can no longer be created.
csv_upload, people_filter, engagement "csv_upload"
Current state of audience creation. syncing means Whop is sending matched rows to connected ad accounts. When a pending audience is waiting on something, such as an ad account to upload to, error_message says what. When status is partial or failed, error_message explains what went wrong.
pending, processing, syncing, ready, partial, failed Total members detected in the source — CSV rows for uploaded lists, matching people for automatic audiences. Always 0 for lookalikes and engagement audiences.
0
When the audience was last updated, as an ISO 8601 timestamp.
"2026-01-01T12:00:00.000Z"

