Skip to main content

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_123456789 with their daily budgets
  • Create an ad creative and an ad for the Spring Sale ad set
  • Add a list of customer emails to the Past Purchasers custom audience

Set up​

Meta Ads needs an OAuth application from your organization before anyone can connect. An organization admin completes these steps once.

  1. Go to Organization > Connectors and find Meta Ads. Click Enable, and choose which tools to allow.
  2. Create an OAuth application in the Meta Ads developer portal.
  3. Add the Redirect URI shown in the connector settings to the application.
  4. Copy the application's Client ID and Client Secret into the connector, then save it.
  5. 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_management
  • ads_read
  • business_management
  • catalog_management
  • instagram_basic
  • pages_manage_ads
  • pages_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.

ToolWhat it does
generate_ad_previewRender a preview of an ad or creative in a specific placement (Feed, Story, Reels, etc.).
get_ad_studyGet a single ad study by id, with type, status, cells, and results.
get_campaignGet a single campaign by id, with status, objective, and budgets.
get_custom_audienceGet a single custom audience by id, with size, status, and subtype.
get_datasetGet a dataset (pixel) node: metadata, Conversions API configuration, and pixel settings.
get_dataset_statsGet a dataset's event volume over a time window, optionally broken down by device or event source.
get_productGet a single product by id, with name, price, availability, and imagery.
get_product_catalogGet a single product catalog by id, with name, vertical, product/feed counts, and owning business.
get_product_feedGet a single product feed's configuration by id: URL, schedule, format, and status.
get_product_setGet a single product set by id, with its filter rule and match count.
list_activitiesList activity log entries for an ad account (who changed what, when).
list_ad_accountsList the ad accounts the token can access, with id (act_<number>), name, currency, and balance.
list_ad_creativesList ad creatives under an ad account, each with its id for attaching to a new ad.
list_ad_imagesList ad images uploaded to an ad account, each with its hash (used to reference it in a creative).
list_ad_setsList ad sets under an ad account, each with its campaign_id for client-side scoping.
list_ad_studiesList the ad studies (A/B tests and lift studies) that impact an ad account.
list_ad_videosList ad videos uploaded to an ad account, each with id, title, and length.
list_adsList ads under an ad account, each with its adset_id and campaign_id for client-side scoping.
list_campaignsList campaigns under an ad account, with status, objective, and budgets.
list_catalog_data_sourcesList the data sources (feeds, uploads, API sources) attached to a product catalog.
list_catalog_diagnosticsList diagnostics (errors, warnings, opportunities) on a product catalog that may affect ad delivery.
list_catalog_event_sourcesList the event sources (pixels, apps, offline conversion sets) connected to a product catalog.
list_custom_audiencesList custom audiences on an ad account, each with name, subtype, and approximate size.
list_custom_conversionsList custom conversions defined on an ad account, each with name, rule, and event type.
list_datasetsList datasets (pixels) on an ad account, each with name and last-fired time.
list_feed_rulesList the supplementary rules applied to a product feed.
list_feed_uploadsList upload sessions for a product feed, with status and error counts.
list_instagram_accountsList Instagram Business/Creator accounts linked to an ad account, each with id and username.
list_instagram_mediaList recent media (posts, reels, stories) on an Instagram Business/Creator account.
list_product_catalogsList product catalogs owned by a Business Manager, with name, vertical, and product count.
list_product_feedsList the product feeds registered on a catalog, each with name and product count.
list_product_set_productsList the products contained in a product set.
list_product_setsList product sets in a catalog, each with name and product count.
list_productsList or search products in a product catalog.
list_promote_pagesList the Facebook Pages that have been used for ads on an ad account, each with id and name.
search_ad_librarySearch the public Meta Ad Library for competitive research.
validate_credentialValidate Meta Ads credentials by reading the token's identity (/me).

Write (15)​

Create or send data.

ToolWhat it does
add_custom_audience_usersAdd users to a customer-list audience by uploading hashed personal data.
connect_catalog_event_sourceConnect one or more event sources (pixels, apps, offline sets) to a catalog for signal matching.
create_adCreate an ad in an ad set.
create_ad_creativeCreate an ad creative under an ad account.
create_ad_setCreate an ad set under a campaign.
create_ad_studyCreate an ad study (A/B test or conversion lift).
create_campaignCreate a campaign under an ad account.
create_custom_audienceCreate a custom audience.
create_feed_ruleCreate a supplementary rule that maps or transforms an attribute on a feed.
create_feed_uploadStart an upload session that fetches a feed file from a URL.
create_productAdd a product to a catalog.
create_product_catalogCreate a product catalog under a Business Manager.
create_product_feedRegister a product feed on a catalog.
create_product_setCreate a product set in a catalog.
send_dataset_eventsSend server events to a dataset via the Conversions API (POST /{pixel_id}/events).

Delete or overwrite (20)​

Remove or replace existing data.

ToolWhat it does
cancel_ad_studyCancel (delete) an ad study by id.
delete_adDelete an ad by id.
delete_ad_creativeDelete an ad creative by id.
delete_ad_setDelete an ad set by id.
delete_campaignDelete a campaign by id.
delete_custom_audienceDelete a custom audience by id.
delete_feed_ruleDelete a feed transformation rule by id without affecting the feed or products.
delete_productDelete a product from a catalog by id.
delete_product_feedDelete a product feed and its schedule by id; products it supplied are removed asynchronously.
delete_product_setDelete a product set by id; products remain in the catalog.
disconnect_catalog_event_sourceDisconnect one or more event sources from a catalog to stop signal matching.
remove_custom_audience_usersRemove users from a customer-list audience by uploading hashed personal data to match.
update_ad_studyEdit an existing ad study's name, description, end time, or cells.
update_campaignUpdate a campaign by id (Meta uses POST, not PATCH).
update_custom_audienceUpdate a custom audience's name, description, or website rule.
update_datasetUpdate a dataset (pixel) setting: name, automatic advanced matching, or data-use.
update_productUpdate a product's fields (name, price, availability, brand, imagery).
update_product_catalogUpdate a product catalog's name or default/fallback image URLs.
update_product_feedUpdate a product feed's name, currency default, or fetch schedules.
update_product_setUpdate a product set's name, filter, or retailer id.
⌘J