Meta Ads
Read and steer Facebook and Instagram ad campaigns: list accounts, ad sets, ads and audiences, pull insights, and create, update or remove a campaign.
Meta Ads is mapped and documented, but one-click connection isn't live yet — the app shows it as Coming soon. Only Google Calendar, Drive, Mail, and Tasks are connectable today; see the Standard integrations catalogue for what's live now.
| Category | 📣 Marketing |
| Connection | Coming soon not yet connectable — once live it will connect via OAuth 2.0. |
| Actions | 11 total — 8 read, 3 write |
Actions
Once connected, Meta Ads exposes the following actions. The AI can call them with #-mentions in chat, an agent can be granted a subset as tools, and a workflow can run them in an integration-action node.
| Action | Type | What it does | Proxy |
|---|---|---|---|
Create Campaigncreate-campaign | Write | Create a campaign. It is created PAUSED unless you say otherwise, so nothing spends until someone turns it on. | Yes |
Delete Campaigndelete-campaign | Write | Delete a campaign and everything under it. Setting the status to ARCHIVED is the reversible option. | Yes |
Get Account Insightsget-account-insights | Read | Read spend, impressions, clicks and reach for a whole ad account over a period. | Yes |
Get Campaignget-campaign | Read | Read one campaign's own settings by id — its name, objective, budget, status and schedule. For what it SPENT and achieved (spend, impressions, clicks, reach) use Get Campaign Insights instead. | Yes |
Get Campaign Insightsget-campaign-insights | Read | Read spend, impressions, clicks and reach for one campaign. | Yes |
List Ad Accountslist-ad-accounts | Read | List the ad accounts this connection can reach. Start here — every other action needs one of these ids. | Yes |
List Ad Setslist-ad-sets | Read | List an ad account's ad sets — the MIDDLE level of the three, which holds the audience targeting, the bid and the schedule. It does not return the creatives; List Ads does that, and List Campaigns returns the budgets above. | Yes |
List Adslist-ads | Read | List an ad account's individual ads — the BOTTOM level of the three, the creatives that actually run. For the audience and schedule around them use List Ad Sets; for budgets and delivery status use List Campaigns. | Yes |
List Campaignslist-campaigns | Read | List an ad account's campaigns, with budgets and why each is or is not delivering. A campaign is the TOP level of the three: campaigns hold ad sets, ad sets hold ads. Use List Ad Sets for targeting and schedule, List Ads for the creatives themselves. | Yes |
List Custom Audienceslist-custom-audiences | Read | List an ad account's custom audiences, with the size range Meta reports and whether each is ready to target. | Yes |
Update Campaignupdate-campaign | Write | Change a campaign's name, budget, schedule or status. Setting the status to ACTIVE starts spending; PAUSED stops it. Only the fields you fill are sent. | Yes |
Actions tagged Write create, update, or delete data. In chat and agent paths they pause for your confirmation before running; workflows treat their deterministic wiring as implicit consent. Agent tools covers how to scope which actions an agent may use.
Spend & quota
Meta Ads is governed per organization: an admin sets a monetary spend cap and a monthly call quota. A quota of 0 disables the integration — it never means unlimited. See the Integrations overview for the full governance model.