Meta Ads
Connects to the Meta (Facebook/Instagram) Marketing API for managing ad campaigns. An agent can list campaigns, ad sets and ads, fetch performance insights, and pause or enable campaigns.
Add to an agent node's tools array with _node_type: "tool-meta-ads". See Connector Reference — How connectors are used.
Authentication
| Field | Required | Description |
|---|---|---|
access_token | Yes (or token) | Meta user or system-user long-lived access token. |
token | Fallback | Used if access_token is not set. |
ad_account_id | Yes | Ad account ID, e.g. act_1234567890 or 1234567890 (the act_ prefix is added automatically if missing). |
{
"name": "meta_ads",
"_node_type": "tool-meta-ads",
"access_token": "{{ secret.META_ACCESS_TOKEN }}",
"ad_account_id": "act_1234567890"
}
Tools
meta_ads_list_campaigns
List Meta (Facebook/Instagram) ad campaigns with status and budget.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
status | string | No | ACTIVE, PAUSED, ARCHIVED (empty = all) |
limit | number | No | Max number of campaigns to return |
Returns: A newline-separated list of [id] name status=... obj=... $budget/day lines, or "No campaigns found.".
meta_ads_campaign_insights
Get performance insights for a Meta campaign: reach, impressions, clicks, CTR, spend, ROAS.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
campaign_id | string | Yes | Campaign ID |
days | number | No | Look-back days (default 30) |
Returns: A multi-line summary with reach, impressions, clicks, CTR, and spend for the look-back period, or "No insights data for campaign: <id>".
meta_ads_list_ad_sets
List Meta ad sets with targeting, budget and optimization goal.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
campaign_id | string | No | Filter by campaign ID (empty = all) |
limit | number | No | Max number of ad sets to return |
Returns: A newline-separated list of [id] name status=... opt=... lines.
meta_ads_list_ads
List individual ads with their creative and delivery status.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
ad_set_id | string | No | Filter by ad set ID |
limit | number | No | Max number of ads to return |
Returns: A newline-separated list of [id] name status=... adset=... lines.
meta_ads_update_campaign
Enable or pause a Meta ad campaign.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
campaign_id | string | Yes | Campaign ID |
status | string | Yes | ACTIVE or PAUSED |
Returns: A confirmation message stating the campaign was updated to the new status.
meta_ads_account_insights
Get overall Meta Ads account performance summary.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
days | number | No | Look-back days (default 30) |
Returns: A multi-line summary with reach, impressions, clicks, CTR, and total spend for the account, or "No account insights found.".