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, account-scoped JWT, App API key, or user OAuth token. Prepend the key or token with Bearer, for example Bearer ***************************.
Headers
A unique key that makes this request safe to retry. See Idempotent requests.
255"d9105228-4a08-46b1-8b91-42fed586d383"
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.
Response
Audience upload accepted.
custom = a customer list (uploaded, or built from saved People filters); lookalike = Meta lookalike built from a custom audience.
custom, lookalike "custom"
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.
When the audience was created, as an ISO 8601 timestamp.
Processing error message. null unless processing is partial or failed.
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.
Audience ID, prefixed adaud_.
When the audience membership was last rebuilt, as an ISO 8601 timestamp. null until the first build completes.
For lookalikes: the upper bound of the similarity band as a fraction (0.02 = top 2%). null for custom audiences.
For lookalikes: the lower bound of the similarity band as a fraction. null for custom audiences and first-tier lookalikes.
Members successfully uploaded to connected ad accounts. Always 0 for lookalikes.
Audience display name.
External audience IDs created on connected ad platforms, such as Meta.
Members processed from the source so far. Always 0 for lookalikes.
Processing progress from 0 to 100.
For lookalikes: the audience this lookalike was built from. null for custom audiences.
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.
csv_upload, people_filter "csv_upload"
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.
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.
When the audience was last updated, as an ISO 8601 timestamp.

