Share Audience - Markifact

Shares an X Ads custom audience with another ad account, read-only or read-write. Both accounts must belong to X business organizations, otherwise X rejects the request.


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

Inputs

Field	Type	Required	Default	Description
`account`	DynamicAccount	Yes	-	Select the X Ads account that owns the audience.
`audience_id`	string or SelectItem	Yes	-	Custom audience ID to share.
`granted_account_id`	string	Yes	-	The X Ads account ID to grant access to. Must be a different account: X rejects sharing an audience back to the account that owns it.
`permission_level`	enum (`READ_ONLY`, `READ_WRITE`)	No	`READ_ONLY`	Access to grant: READ_ONLY (default, the other account can target the audience) or READ_WRITE (it can also modify members).

SelectItem

Field	Type	Required	Default	Description
`value`	string	Yes	-	The value of the selectable item.
`label`	string	Yes	-	The label of the selectable item, used for display purposes. If not provided, defaults to the value.

Output

Type: Dict Returns the created audience permission. Fields: dynamic (depend on the inputs)