Update Custom Audience - Markifact

Updates a Meta custom audience (rename, description, website rule, retention window, opt-out link, customer file source, lookalike spec, and more) or permanently deletes it via action=‘delete’. Fields are sent to Meta as-is; use meta_list_custom_audiences to find audience_id.


App	Meta Ads
Operation ID	`meta_update_custom_audience`
Type	Action
Connection	`meta_ads` (required)
Credits per run	1
Agent / MCP tool	Yes
Requires approval	Yes (write operation)

Inputs

Field	Type	Required	Default	Description
`audience_id`	string	Yes	-	Custom audience ID, e.g. from meta_list_custom_audiences
`action`	string or SelectableOption	No	`update`	’update’ changes the provided fields; ‘delete’ permanently deletes the audience (it is removed from any ad sets still using it) and ignores all other fields.
`name`	string	No	-	New audience name
`description`	string	No	-	New audience description
`rule`	object or string	No	-	Replacement website-audience rule, sent to Meta as-is. Same Audience Rules shape as meta_create_custom_audience: {‘inclusions’: {‘operator’: ‘or’, ‘rules’: [{‘event_sources’: [{‘type’: ‘pixel’, ‘id’: ‘<PIXEL_ID>’}], ‘retention_seconds’: 2592000, ‘filter’: {…}}]}}. Only valid for website custom audiences.
`retention_days`	integer	No	-	New lookback window in days (Meta caps this per audience type, e.g. 180 for website, 365 for engagement)
`opt_out_link`	string	No	-	URL where people can opt out of the audience
`customer_file_source`	string or SelectableOption	No	-	Source of customer data, for customer-list audiences
`allowed_domains`	array of string	No	-	Domains allowed as traffic sources for the audience
`tags`	array of string	No	-	Tags to organize the audience
`use_in_campaigns`	boolean	No	-
`product_set_id`	string	No	-	Product set ID, for product audiences
`lookalike_spec`	object or string	No	-	Lookalike spec JSON, for lookalike audiences, e.g. {“type”: “similarity”, “origin_audience_id”: “<ID>”, “country”: “US”}

SelectableOption

Field	Type	Required	Default	Description
`value`	string	Yes	-
`label`	string	Yes	-

Output

Type: Dict Returns the audience id, action performed, and updated fields. Fields: audience_id, action, updated_fields