Skip to main content
X Ads Custom Audiences let you target ads on X to people from your own first-party data. The Cargo integration lets you create Custom Audiences, push contacts into them, remove contacts, and check audience size and targetability, all from your workflows.

​
Authentication

Connect to X Ads using OAuth.
The signed-in X account must have access to the ad accounts you want to push audiences into. X Ads tokens do not expire, but revoking Cargo’s access in your X settings disconnects the connector.

​
X Ads actions

​
Create Audience

Create a new Custom Audience on an X Ads account. Returns The newly created customAudienceId, plus the name and the accountId.

​
Add Contact to Audience

Add a single contact to a Custom Audience. At least one identifier (email, phone, handle, or user ID) is required.
Cargo normalizes and SHA-256 hashes every identifier before sending it to X. Send raw values, not pre-hashed ones.
X processes audience changes in batches every few hours. Membership expires after 13 months, X’s default.

​
Remove Contact from Audience

Remove a contact from a Custom Audience by email.

​
Create Report

Fetch the size and targetability of a Custom Audience. Returns
An audience can only be targeted once it matches at least 100 users who were active on X in the past 90 days.

​
Use cases

Sync engaged contacts into a Custom Audience and retarget them on X.
Keep customers or unsubscribed contacts in an audience and exclude it from campaigns.