Meta Custom Audiences
App · 12 actions
Create customer-list audiences, add or remove members, and manage audience sharing.
Actions
| Action | What it does |
|---|---|
| Add members | Add members in Meta Custom Audiences. |
| Create audience | Create audience in Meta Custom Audiences. |
| Delete audience | Delete audience in Meta Custom Audiences. |
| Get ad account | Get ad account in Meta Custom Audiences. |
| Get audience | Get audience in Meta Custom Audiences. |
| List ad accounts | List ad accounts in Meta Custom Audiences. |
| List audiences | List audiences in Meta Custom Audiences. |
| List shared accounts | List shared accounts in Meta Custom Audiences. |
| Remove members | Remove members in Meta Custom Audiences. |
| Share audience | Share audience in Meta Custom Audiences. |
| Unshare audience | Unshare audience in Meta Custom Audiences. |
| Update audience | Update audience in Meta Custom Audiences. |
Add members
Add members in Meta Custom Audiences.
Inputs
- Audience
audience_idtextRequired - Audience ID.
- Identifier type
identifier_typetextRequired - Identifier type.One of:
EMAIL,PHONE. - Identifiers
identifierslistRequired - Identifiers.
Outputs
dataobject- Meta Custom Audiences response data.
Example output
{
"data": {
"audience_id": "example",
"num_invalid_entries": 1,
"num_received": 1,
"session_id": "example"
}
}Create audience
Create audience in Meta Custom Audiences.
Inputs
- Ad account
ad_account_idtextRequired - Ad account ID.
- Name
nametextRequired - Name.
- Description
descriptiontext - Description.
- Customer file source
customer_file_sourcetextRequired - Customer file source.One of:
USER_PROVIDED_ONLY(User provided only),PARTNER_PROVIDED_ONLY(Partner provided only),BOTH_USER_AND_PARTNER_PROVIDED(Both user and partner provided). - Retention days
retention_daysnumber - Retention days.From 1 to 180.
Outputs
dataobject- Meta Custom Audiences response data.
Example output
{
"data": {
"id": "example"
}
}Delete audience
Delete audience in Meta Custom Audiences.
Inputs
- Audience
audience_idtextRequired - Audience ID.
Outputs
dataobject- Meta Custom Audiences response data.
Example output
{
"data": {
"success": false
}
}Get ad account
Get ad account in Meta Custom Audiences.
Inputs
- Ad account
ad_account_idtextRequired - Ad account ID.
Outputs
dataobject- Meta Custom Audiences response data.
Example output
{
"data": {
"account_id": "example",
"id": "example",
"name": "example"
}
}Get audience
Get audience in Meta Custom Audiences.
Inputs
- Audience
audience_idtextRequired - Audience ID.
Outputs
dataobject- Meta Custom Audiences response data.
Example output
{
"data": {
"delivery_status": {},
"description": "example",
"id": "example",
"name": "example",
"operation_status": {},
"subtype": "example",
"time_updated": 1
}
}List ad accounts
List ad accounts in Meta Custom Audiences.
Inputs
- After
aftertext - After.
- Limit
limitnumber - Limit.From 1 to 100.
Outputs
dataobject- Meta Custom Audiences response data.
has_moretrue/false- Whether another page is available.
next_cursortext- Pass this value to the next page input.
recordslist- The records on this page.
Example output
{
"data": {
"data": [],
"paging": {}
},
"has_more": false,
"next_cursor": null,
"records": []
}List audiences
List audiences in Meta Custom Audiences.
Inputs
- Ad account
ad_account_idtextRequired - Ad account ID.
- After
aftertext - After.
- Limit
limitnumber - Limit.From 1 to 100.
Outputs
dataobject- Meta Custom Audiences response data.
has_moretrue/false- Whether another page is available.
next_cursortext- Pass this value to the next page input.
recordslist- The records on this page.
Example output
{
"data": {
"data": [],
"paging": {}
},
"has_more": false,
"next_cursor": null,
"records": []
}List shared accounts
List shared accounts in Meta Custom Audiences.
Inputs
- Audience
audience_idtextRequired - Audience ID.
- After
aftertext - After.
- Limit
limitnumber - Limit.From 1 to 100.
- Permissions
permissionstext - Permissions.One of:
targeting,targeting_and_insights(Targeting and insights).
Outputs
dataobject- Meta Custom Audiences response data.
has_moretrue/false- Whether another page is available.
next_cursortext- Pass this value to the next page input.
recordslist- The records on this page.
Example output
{
"data": {
"data": [],
"paging": {}
},
"has_more": false,
"next_cursor": null,
"records": []
}Remove members
Remove members in Meta Custom Audiences.
Inputs
- Audience
audience_idtextRequired - Audience ID.
- Identifier type
identifier_typetextRequired - Identifier type.One of:
EMAIL,PHONE. - Identifiers
identifierslistRequired - Identifiers.
Outputs
dataobject- Meta Custom Audiences response data.
Example output
{
"data": {
"audience_id": "example",
"num_invalid_entries": 1,
"num_received": 1,
"session_id": "example"
}
}Share audience
Share audience in Meta Custom Audiences.
Inputs
- Audience
audience_idtextRequired - Audience ID.
- Ad accounts
ad_accountslistRequired - Ad accounts.
- Permissions
permissionstext - Permissions.One of:
targeting,targeting_and_insights(Targeting and insights).
Outputs
dataobject- Meta Custom Audiences response data.
Example output
{
"data": {
"success": false
}
}Unshare audience
Unshare audience in Meta Custom Audiences.
Inputs
- Audience
audience_idtextRequired - Audience ID.
- Ad accounts
ad_accountslistRequired - Ad accounts.
Outputs
dataobject- Meta Custom Audiences response data.
Example output
{
"data": {
"success": false
}
}Update audience
Update audience in Meta Custom Audiences.
Inputs
- Audience
audience_idtextRequired - Audience ID.
- Name
nametext - Name.
- Description
descriptiontext - Description.
Outputs
dataobject- Meta Custom Audiences response data.
Example output
{
"data": {
"success": false
}
}