Meta Ads
Meta (Facebook) Marketing API connector for managing ad accounts, campaigns, ad sets, ads, ad creatives, product catalogs, custom audiences, datasets (pixels), ad studies, and more on the Graph API.
Categories: Advertising, Marketing
What you can ask
- List the active campaigns in ad account
act_123456789with their daily budgets - Create an ad creative and an ad for the
Spring Salead set - Add a list of customer emails to the
Past Purchaserscustom audience
Set up
Meta Ads needs an OAuth application from your organization before anyone can connect. An organization admin completes these steps once.
- Go to Organization > Connectors and find Meta Ads. Click Enable, and choose which tools to allow.
- Create an OAuth application in the Meta Ads developer portal.
- Add the Redirect URI shown in the connector settings to the application.
- Copy the application's Client ID and Client Secret into the connector, then save it.
- Each member connects their own account the first time they use it.
⚠️ Warning: Do not enter your Devs.ai or Meta Ads login email or password in the OAuth application fields.
To use one account for the whole organization, turn on Share one connection with everyone. Every member's agents then act as that account, with exactly the access it has.
OAuth scopes used by these tools (7)
Grant the scopes for the tools you plan to allow.
ads_managementads_readbusiness_managementcatalog_managementinstagram_basicpages_manage_adspages_show_list
Tools
Meta Ads offers 72 tools. Admins choose which ones agents can use. See Tool permission groups.
Read (37)
View and search information without changing it.
| Tool | What it does |
|---|---|
generate_ad_preview | Render a preview of an ad or creative in a specific placement (Feed, Story, Reels, etc.). |
get_ad_study | Get a single ad study by id, with type, status, cells, and results. |
get_campaign | Get a single campaign by id, with status, objective, and budgets. |
get_custom_audience | Get a single custom audience by id, with size, status, and subtype. |
get_dataset | Get a dataset (pixel) node: metadata, Conversions API configuration, and pixel settings. |
get_dataset_stats | Get a dataset's event volume over a time window, optionally broken down by device or event source. |
get_product | Get a single product by id, with name, price, availability, and imagery. |
get_product_catalog | Get a single product catalog by id, with name, vertical, product/feed counts, and owning business. |
get_product_feed | Get a single product feed's configuration by id: URL, schedule, format, and status. |
get_product_set | Get a single product set by id, with its filter rule and match count. |
list_activities | List activity log entries for an ad account (who changed what, when). |
list_ad_accounts | List the ad accounts the token can access, with id (act_<number>), name, currency, and balance. |
list_ad_creatives | List ad creatives under an ad account, each with its id for attaching to a new ad. |
list_ad_images | List ad images uploaded to an ad account, each with its hash (used to reference it in a creative). |
list_ad_sets | List ad sets under an ad account, each with its campaign_id for client-side scoping. |
list_ad_studies | List the ad studies (A/B tests and lift studies) that impact an ad account. |
list_ad_videos | List ad videos uploaded to an ad account, each with id, title, and length. |
list_ads | List ads under an ad account, each with its adset_id and campaign_id for client-side scoping. |
list_campaigns | List campaigns under an ad account, with status, objective, and budgets. |
list_catalog_data_sources | List the data sources (feeds, uploads, API sources) attached to a product catalog. |
list_catalog_diagnostics | List diagnostics (errors, warnings, opportunities) on a product catalog that may affect ad delivery. |
list_catalog_event_sources | List the event sources (pixels, apps, offline conversion sets) connected to a product catalog. |
list_custom_audiences | List custom audiences on an ad account, each with name, subtype, and approximate size. |
list_custom_conversions | List custom conversions defined on an ad account, each with name, rule, and event type. |
list_datasets | List datasets (pixels) on an ad account, each with name and last-fired time. |
list_feed_rules | List the supplementary rules applied to a product feed. |
list_feed_uploads | List upload sessions for a product feed, with status and error counts. |
list_instagram_accounts | List Instagram Business/Creator accounts linked to an ad account, each with id and username. |
list_instagram_media | List recent media (posts, reels, stories) on an Instagram Business/Creator account. |
list_product_catalogs | List product catalogs owned by a Business Manager, with name, vertical, and product count. |
list_product_feeds | List the product feeds registered on a catalog, each with name and product count. |
list_product_set_products | List the products contained in a product set. |
list_product_sets | List product sets in a catalog, each with name and product count. |
list_products | List or search products in a product catalog. |
list_promote_pages | List the Facebook Pages that have been used for ads on an ad account, each with id and name. |
search_ad_library | Search the public Meta Ad Library for competitive research. |
validate_credential | Validate Meta Ads credentials by reading the token's identity (/me). |
Write (15)
Create or send data.
| Tool | What it does |
|---|---|
add_custom_audience_users | Add users to a customer-list audience by uploading hashed personal data. |
connect_catalog_event_source | Connect one or more event sources (pixels, apps, offline sets) to a catalog for signal matching. |
create_ad | Create an ad in an ad set. |
create_ad_creative | Create an ad creative under an ad account. |
create_ad_set | Create an ad set under a campaign. |
create_ad_study | Create an ad study (A/B test or conversion lift). |
create_campaign | Create a campaign under an ad account. |
create_custom_audience | Create a custom audience. |
create_feed_rule | Create a supplementary rule that maps or transforms an attribute on a feed. |
create_feed_upload | Start an upload session that fetches a feed file from a URL. |
create_product | Add a product to a catalog. |
create_product_catalog | Create a product catalog under a Business Manager. |
create_product_feed | Register a product feed on a catalog. |
create_product_set | Create a product set in a catalog. |
send_dataset_events | Send server events to a dataset via the Conversions API (POST /{pixel_id}/events). |
Delete or overwrite (20)
Remove or replace existing data.
| Tool | What it does |
|---|---|
cancel_ad_study | Cancel (delete) an ad study by id. |
delete_ad | Delete an ad by id. |
delete_ad_creative | Delete an ad creative by id. |
delete_ad_set | Delete an ad set by id. |
delete_campaign | Delete a campaign by id. |
delete_custom_audience | Delete a custom audience by id. |
delete_feed_rule | Delete a feed transformation rule by id without affecting the feed or products. |
delete_product | Delete a product from a catalog by id. |
delete_product_feed | Delete a product feed and its schedule by id; products it supplied are removed asynchronously. |
delete_product_set | Delete a product set by id; products remain in the catalog. |
disconnect_catalog_event_source | Disconnect one or more event sources from a catalog to stop signal matching. |
remove_custom_audience_users | Remove users from a customer-list audience by uploading hashed personal data to match. |
update_ad_study | Edit an existing ad study's name, description, end time, or cells. |
update_campaign | Update a campaign by id (Meta uses POST, not PATCH). |
update_custom_audience | Update a custom audience's name, description, or website rule. |
update_dataset | Update a dataset (pixel) setting: name, automatic advanced matching, or data-use. |
update_product | Update a product's fields (name, price, availability, brand, imagery). |
update_product_catalog | Update a product catalog's name or default/fallback image URLs. |
update_product_feed | Update a product feed's name, currency default, or fetch schedules. |
update_product_set | Update a product set's name, filter, or retailer id. |