Facebook Custom Audiences, Lookalikes & Hash PII Automatically
Under maintenancePricing
from $0.01 / 1,000 results
Facebook Custom Audiences, Lookalikes & Hash PII Automatically
Under maintenanceCreate & manage Facebook Custom Audiences via Meta Marketing API. Add/remove users w/SHA256 hashing, create lookalike audiences share & audience insights. Create a new custom audience Get details of specific audience List all custom audiences Update audience name/description Delete a custom audience
Pricing
from $0.01 / 1,000 results
Rating
0.0
(0)
Developer
The Howlers
Maintained by CommunityActor stats
0
Bookmarked
3
Total users
1
Monthly active users
7 days ago
Last modified
Categories
Share
Facebook Custom Audiences - Meta Marketing API
Create and manage Facebook Custom Audiences via Meta Marketing API. Add/remove users with auto-hashing, create lookalike audiences, share across ad accounts, get audience insights. Direct integration with Facebook Ads.
BYOK (Bring Your Own Key) -- you provide your own API credentials.
Before You Start
This actor requires your own API credentials to fetch real data.
Where to get your key: Facebook Marketing API access token with ads_management permission
Quick Start
Run with real data
Input Parameters
| Parameter | Type | Default | Required | Description |
|---|---|---|---|---|
task | string | "list_audiences" | Yes* | The operation to perform |
accessToken | string | - | Yes* | Facebook Marketing API access token with ads_management permission |
adAccountId | string | - | No | Facebook Ad Account ID (format: act_123456789) |
audienceId | string | - | No | ID of the custom audience to operate on |
audienceName | string | - | No | Name for the custom audience |
audienceDescription | string | - | No | Description for the custom audience |
optOutLink | string | - | No | URL where users can opt out of targeting |
customerFileSource | string | "USER_PROVIDED_ONLY" | No | Source of customer data for compliance |
users | string | - | No | JSON array of user objects with email, phone, firstName, lastName, city, state, country, zip fields |
schema | string | "EMAIL,PHONE,FN,LN" | No | Schema of user data being uploaded (comma-separated: EMAIL,PHONE,FN,LN,CT,ST,COUNTRY,ZIP) |
isAlreadyHashed | boolean | false | No | Set to true if user data is already SHA256 hashed |
lookalikeSpec | string | - | No | JSON object with origin_audience_id, starting_ratio, ratio, and country |
targetAdAccountId | string | - | No | Ad account ID to share audience with (for share_audience task) |
retentionDays | integer | 180 | No | Number of days to retain audience members |
webhookUrl | string | - | No | URL to receive results via webhook |
Pricing
This actor uses pay-per-event billing:
| Event | Description | Price |
|---|---|---|
| Audience Operation | Each Facebook Custom Audience operation processed | $0.02 |
Troubleshooting
"API key is required"
- Add your API key in the input
"API error 403" or "Unauthorized"
Your API key is invalid, expired, or doesn't have access to this specific API endpoint. Double-check your key and account permissions.
"API error 429" or "Rate limit"
Too many requests. Wait a minute and try again, or reduce the number of items per run.
No results or empty dataset
Check the run log for error messages. Common causes:
- Invalid input format (check the examples above)
- API key without proper permissions
- The target data doesn't exist or is too small to track
How do I test without an API key?
Built by John Rippy | Actor Arsenal
