Add custom audience member

Add a single contact to a Facebook custom audience. The contact is resolved from contactId and its identifiers are hashed before being sent to Meta. Use the batch endpoint for more than one member.

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

contactIdstringrequired

Contact identifier

Example:contact_123

fbAdAccountIdstring

Facebook ad account ID

Example:act_123456

Response

200

application/json

Acknowledgement that the contact was added, naming the audience in msg

statusnumberrequired

Always 200. Mirrors the HTTP status rather than reporting anything additional.

Example:200

msgstringrequired

Human-readable confirmation. Wording varies with the operation performed.

Example:Successfully updated audience