Batch update audience members

Add or remove members in bulk from a Facebook custom audience, sourced from a CSV or one or more smart lists — at least one of csvPath or smartlistIds is required. The work is queued rather than performed inline, so the acknowledgement confirms only that the job was accepted; nothing about the outcome is reported here. Unlike the single-member endpoints this one answers with { success: true } rather than a status-and-message body.

Authorizations

Authorizationstringheaderrequired

Bearer authentication header of the form Bearer <token>, where <token> is your access token.

Scope:adPublishing.write

Auth methods:OAuthPrivate Integration

Token type:Sub-Account Token

Request​

Headers

Versionstringrequired

API Version

Available optionsv3

Example:v3

Path Parameters

customAudienceIdstringrequired

Custom audience identifier

Example:23851234567890123

Body

application/json

locationIdstringrequired

Location identifier

Example:loc_abc123

csvPathstring

CSV file path

Example:/uploads/audience.csv

operationTypestringrequired

Batch operation type

Available optionsADDREMOVEREPLACE

Example:ADD

smartlistIdsstring[]

Smartlist IDs array

Example:["list_1","list_2"]

dynamicAudiencestring

Dynamic audience flag

Example:true

Response

200

application/json

Acknowledgement that the bulk update was queued

successbooleanrequired

True when the operation succeeded

Example:true