Facebook Custom Audiences

Build a new Facebook Custom Audience from scratch, naming it and defining the data source type so the agent can start populating it immediately.

Hash and append a customer email address to an existing Custom Audience so Facebook can match it against its user graph for ad targeting.

Strip a specific hashed email from a Custom Audience to suppress ads for customers who have churned, unsubscribed, or converted.

Send a custom authenticated request to the Facebook Marketing API for operations not covered by standard actions, giving the agent direct access to advanced audience and ad management endpoints.

Retrieve the full list of Custom Audiences in an ad account so the agent can audit sizes, statuses, and names before deciding where to route new customer data.

Fetch metadata for a single Custom Audience — including its current size, delivery status, and data source — so the agent can make targeting decisions based on up-to-date information.

Modify the name, description, or retention window of an existing Custom Audience so the agent can keep audience definitions accurate as business rules evolve.

Permanently remove a Custom Audience from the ad account to declutter targeting, honour data deletion requests, and eliminate stale segments that could skew future lookalike seeds.

Upload a batch of hashed user identifiers — emails, phone numbers, or MAIDs — to an existing Custom Audience in a single API call, bypassing the one-at-a-time limit.

Delete a batch of hashed user identifiers from a Custom Audience at once, keeping suppression lists accurate without looping through individual Remove Email calls.

Generate a Facebook Lookalike Audience from an existing Custom Audience seed, letting the agent scale targeting to millions of statistically similar users beyond the original list.

Retrieve ad account details including spend limits, currency, and status so the agent can validate the account is active and within budget before launching new audience operations.

Pull demographic and interest breakdowns for a Custom Audience so the agent can surface composition data that informs creative strategy and lookalike seed selection.

Grant another Facebook ad account access to a Custom Audience, letting the agent propagate curated targeting lists across a brand portfolio without re-uploading data.

Retrieve an estimated reach count for a Custom Audience before launching a campaign, so the agent can confirm targeting volume is sufficient and surface-level targeting constraints are met.

Fires when a Custom Audience's matched user count crosses a configured minimum, signalling the segment is large enough to activate for campaigns.

Fires when Facebook finishes processing a bulk upload and the Custom Audience status transitions to 'Ready', confirming matched users are deliverable.

Fires when a new Custom Audience is successfully created in the ad account, allowing the agent to react with immediate population, sharing, or documentation steps.

Fires when a user's retention window elapses and they are automatically removed from a Custom Audience, signalling the agent to decide whether to re-add, suppress, or escalate.

Fires when a data sync or audience upload to the Facebook ad account fails, allowing the agent to retry, alert the team, and log the failure before it silently affects campaign delivery.

Fires when Facebook recalculates the match rate of a Custom Audience after a data update, letting the agent catch quality drops and take corrective action before delivery suffers.

Fires when Facebook finishes building a Lookalike Audience from its seed Custom Audience, allowing the agent to immediately add it to a campaign or notify the team the prospecting layer is live.