Copy Ad Object
Copy a Meta Campaign, Ad Set, or Ad while explicitly selecting its resource type and supported copy options.
ActionTry it
Integrate Meta Ads
with your AI CRM
Create, edit and get insights from ads across Meta technologies, including Facebook, Instagram, Messenger, WhatsApp and more.
Explore Triggers and Actions
Create Ad
Create a new ad within an ad set using the Meta Marketing API, with image, video, or carousel creative content.
ActionTry it
Create Ad Creative
Create a new ad creative using the Meta Marketing API. Ad creatives are reusable visual and interactive elements that define how your ad looks and behaves: - Can be used in multiple ads - Support various formats (image, video, carousel) - Include text, media, and call-to-action buttons - Must follow Meta's ad policies
ActionTry it
Create Ad Set
Create a new ad set within a campaign using the Meta Marketing API. Supports detailed targeting options, budgets, and optimization goals.
ActionTry it
Create Ad Study
Create a Meta A/B test or other ad study under a business, including its cells and tested ad entities.
ActionTry it
Create Ad Video
Upload an ad video asset; Meta may keep processing it after returning its ID.
ActionTry it
Create Campaign
Create a new advertising campaign using the Meta Marketing API. Supports various campaign objectives, budgets, and bidding strategies.
ActionTry it
Create Catalog Product Set
Create a persistent product set in a Meta product catalog and return its ID. Omitting filter or passing an empty object includes all catalog products. Requires the catalog_management OAuth scope.
ActionTry it
Create Custom Audience
Create a new custom audience using the Meta Marketing API. Supports various types of custom audiences including customer lists, website visitors, and app users.
ActionTry it
Create Custom Conversion
Create a persistent custom-conversion definition in a Meta ad account and return its ID. This toolkit does not expose a matching archive or delete action.
ActionTry it
Create Lead Form
Create a persistent lead-generation form owned by a Facebook Page and return its ID. This toolkit does not expose a matching archive or delete action.
ActionTry it
Create Test Lead
Submit a disposable test lead to an existing Meta lead-generation form for delivery verification. Meta permits only one test lead per form at a time, and submitted field names must exist on the target form.
ActionTry it
Delete Ad Object
Delete an Ad Set, Ad, or Ad Creative by ID; the supplied object type is not verified, so the ID determines the object targeted. Meta marks the object DELETED rather than guaranteeing permanent removal.
ActionTry it
Delete Campaign
Delete an advertising campaign using the Meta Marketing API. This marks the campaign as DELETED, which prevents it from delivering ads. Note that deleted campaigns are not permanently removed from Meta's systems and can still be viewed in reports.
ActionTry it
Estimate Ad Delivery
Estimate monthly audience delivery for targeting and optimization settings in a Meta ad account.
ActionTry it
Estimate Targeting Reach
Estimate the audience-size range for a Meta ad account and structured targeting specification containing at least one country. The response includes estimate readiness and lower and upper bounds; a bound of -1 indicates an unavailable estimate.
ActionTry it
Generate Ad Previews
Render previews for a provider-native creative specification in a Meta ad account and return the generated HTML bodies.
ActionTry it
Get Ad Accounts
Retrieve one page of directly assigned ad accounts for the authenticated user, including account IDs, names, and other requested account details.
ActionTry it
Get Ad Creative
Get Ad Creative
ActionTry it
Get Ad Preview
Render a placement-specific preview for an existing Meta Ad or Ad Creative.
ActionTry it
Get Ad Study
Get one Meta ad study by ID, including projected cells and timing.
ActionTry it
Get Catalog Event Stats
Read one page of product-match event statistics for a Meta product catalog. Requires the catalog_management OAuth scope, which is not in the default Meta Ads scopes.
ActionTry it
Get Current Meta App
Return selected metadata for the Meta application associated with the connected access token.
ActionTry it
Get Insights
Get insights data for a Meta Ads object (ad account, campaign, ad set, or ad) using the Meta Marketing API. Supports various metrics, breakdowns, and filtering options with flexible date ranges. Results are paginated; follow `paging.cursors.after` or `paging.next` to retrieve all rows. Missing metric values in results should not be assumed to be zero.
ActionTry it
Get Meta Object
Retrieve data for a Meta Marketing API object by numeric ID, an act_-prefixed numeric ID, or me. Supports field selection for objects such as ad accounts, campaigns, ad sets, ads, creatives, pages, and users.
ActionTry it
Get Multiple Meta Objects
Retrieve selected fields for up to 50 distinct Meta Marketing API objects. Results are keyed by object ID and may contain per-object errors; the connected token needs authorization for the requested objects and fields.
ActionTry it
Get Page Accounts
Retrieve pages managed by the authenticated user, including page access tokens when requested. Results are paginated; use `paging.cursors.after` as the `after` input to retrieve the next page.
ActionTry it
Get Pixel Event Stats
Read recent Pixel event-count and processing statistics, optionally restricted to server events and one event name, to verify aggregate ingestion.
ActionTry it
Get User
Tool to retrieve information about the authenticated user from Meta (Facebook) Graph API. Use when you need to get the current user's profile information such as name, email, or other user details.
ActionTry it
Get Video
DEPRECATED: Use METAADS_GET_OBJECT instead. Tool to retrieve video information from Meta's Graph API by video ID. Use when you need to get video details such as the source URL for playback/download, permalink URL to view on Facebook, or other video metadata like title, description, length, and thumbnails.
ActionTry it
List Activities
List activity history for a Meta ad account or ad set.
ActionTry it
List Ad Account Pixels
List the Pixels and consolidated datasets associated with an ad account so a usable data-source ID can be selected for Conversions API events.
ActionTry it
List Ad Account Recommendations
Return one page of Meta recommendations for an advertising account.
ActionTry it
List Ad Creatives
List one page of ad creatives under a Meta Ads account to view or analyze creative assets.
ActionTry it
List Ad Images
List one page of image assets in a Meta ad account, optionally restricted to exact image hashes.
ActionTry it
List Ad Network Analytics
Tool to retrieve ad network analytics for a Meta Business using the Meta Marketing API. Use when you need to get ad network performance metrics such as revenue or impressions.
ActionTry it
List Ad Network Analytics Results
Tool to retrieve ad network analytics results for Facebook Audience Network. Use when you need to get performance data from ads displayed through Facebook Audience Network on third-party apps and websites for a specific business, app, or property.
ActionTry it
List Ad Rule History
Return one page of historical changes and executions for a Meta Automated Rule. Use next_cursor to retrieve another page when has_more is true.
ActionTry it
List Ad Studies
List one page of A/B tests and other ad studies owned by a Meta business, including projected cells.
ActionTry it
List Ad Videos
List one page of video assets in a Meta ad account, optionally filtered by title, dimensions, duration, or aspect ratio.
ActionTry it
List Ads
List a page of ads under a Meta ad account, with optional selection of returned fields.
ActionTry it
List Agencies
Tool to retrieve agencies associated with a Meta Business or Ad Account. Use when you need to get the list of agencies that have access to manage a specific business or ad account.
ActionTry it
List Assigned Pages
Tool to retrieve Facebook Pages assigned to a business user via Meta Marketing API. Use when you need to get the list of pages a business user has access to.
ActionTry it
List Assigned Users
Tool to list users assigned to a Facebook Page or Ad Account within a specific business context. Use when you need to retrieve the list of users who have access to a Page or Ad Account and their associated task permissions.
ActionTry it
List Business Ad Accounts
Retrieve a page of ad accounts owned by a specific Business Manager, including account IDs, names, and status.
ActionTry it
List Business Invoices
Tool to retrieve business invoices from Meta Marketing API. Use when you need to fetch invoice data for a business including amounts, due dates, and payment status.
ActionTry it
List Business Users
List active human users associated with a Meta Business Manager.
ActionTry it
List Businesses
List a page of Business Managers accessible to the authenticated Meta principal via /me/businesses. Requires the business_management permission on the connected token.
ActionTry it
List Campaigns
List one page of campaigns belonging to a Meta ad account.
ActionTry it
List Catalog Product Feeds
Return one page of product feeds configured for a Meta product catalog. Requires the catalog_management OAuth scope, which is not in the default Meta Ads scopes.
ActionTry it
List Catalog Product Sets
Return one filtered page of product sets from a Meta product catalog.
ActionTry it
List Catalog Products
Return one filtered page of products from a Meta product catalog.
ActionTry it
List Client Ad Accounts
List one page of client ad accounts shared with a Meta Business Manager.
ActionTry it
List Client Apps
Tool to retrieve client apps associated with a Meta Business using the Marketing API. Use when you need to get information about apps linked to a specific business.
ActionTry it
List Client Instagram Assets
Tool to retrieve Instagram assets that are shared with a business as a client using the Meta Marketing API. Use when you need to fetch Instagram accounts or assets linked to a specific business ID.
ActionTry it
List Client Offsite Signal Container Business Objects
Retrieve one page of client offsite signal container business objects for a business using the Meta Marketing API.
ActionTry it
List Client Pages
Tool to retrieve client pages associated with a Meta business. Use when you need to get the list of pages that a business manages on behalf of clients.
ActionTry it
List Clients
Tool to retrieve client businesses associated with a Meta Business Manager. Use when you need to get the list of businesses that are clients of a specific Business Manager.
ActionTry it
List Collaborative Ads Collaboration Requests
Tool to retrieve collaborative ads collaboration requests for a Meta Business using the Marketing API. Use when you need to get collaboration requests related to collaborative advertising partnerships for a specific business.
ActionTry it
List Collaborative Ads Suggested Partners
Tool to retrieve collaborative ads suggested partners for a business from Meta Marketing API. Use when you need to discover potential partnership opportunities for collaborative advertising campaigns.
ActionTry it
List Comments
Return one page from the comments edge of a Page-owned post, photo, video, comment, or reply. The connected token needs pages_read_engagement and pages_read_user_content for that Page; Meta can require the Page MODERATE task to expose Page-post comment IDs.
ActionTry it
List Custom Audiences
List one page of custom audiences in a Meta ad account, with field projection and optional business, primary-audience, or Pixel constraints.
ActionTry it
List Custom Conversions
List one page of custom-conversion definitions in a Meta ad account, with field projection and opaque cursor pagination.
ActionTry it
List Initiated Audience Sharing Requests
Tool to retrieve initiated audience sharing requests for a business using the Meta Marketing API. Use when you need to get the list of audience sharing requests that have been initiated by a business.
ActionTry it
List Leads
List one page of leads belonging to a Meta Ad or Leadgen Form.
ActionTry it
List Managed Partner Ads Funding Source Details
Tool to retrieve managed partner ads funding source details for a Meta Business. Use when you need to get funding source information for managed partner ads associated with a specific business.
ActionTry it
List Owned Apps
Tool to retrieve apps owned by a business from Meta Marketing API. Use when you need to get information about apps associated with a business account.
ActionTry it
List Owned Businesses
Tool to retrieve businesses owned by a parent Business Manager from Meta Marketing API. Use when you need to list child businesses managed under a Business Manager account in a Tier-2 business hierarchy.
ActionTry it
List Owned Instagram Assets
Tool to list Instagram accounts/assets owned by a Meta Business. Use when you need to retrieve the Instagram Business Accounts associated with a specific Meta Business.
ActionTry it
List Owned Offsite Signal Container Business Objects
Retrieve one page of owned offsite signal container business objects associated with a specific business ID from the Meta Marketing API.
ActionTry it
List Owned Pages
Retrieve a page of Facebook Pages owned by a Business Manager from the Meta Marketing API.
ActionTry it
List Owned Product Catalogs
Return one page of product catalogs owned by a Meta Business Manager.
ActionTry it
List Pending Client Ad Accounts
Tool to retrieve pending client ad account access requests for a Business Manager from Meta Ads. Use when you need to get ad accounts that are awaiting approval to be added as clients to a business.
ActionTry it
List Pending Client Apps
Tool to retrieve pending client apps for a Meta Business. Use when you need to list apps that are pending approval or connection to a business account.
ActionTry it
List Pending Client Pages
Tool to retrieve pending client pages for a Business Manager using the Meta Marketing API. Use when you need to see which Facebook Pages have pending access requests from the business.
ActionTry it
List Pending Owned Ad Accounts
Tool to retrieve pending owned ad accounts for a Business Manager account from Meta Marketing API. Use when you need to list ad accounts with pending ownership status for a specific business.
ActionTry it
List Pending Owned Pages
Tool to retrieve Pages with pending ownership status for a Business Manager from Meta Marketing API. Use when you need to get a list of Facebook Pages that are pending approval or verification for a business to own.
ActionTry it
List Pending Shared Offsite Signal Container Business Objects
Tool to retrieve pending shared offsite signal container business objects from Meta Marketing API. Use when you need to get information about pending shared offsite signal containers associated with a business account.
ActionTry it
List Pending Users
Tool to retrieve pending users from a Business Manager in Meta Marketing API. Use when you need to get information about users with pending invitations to a Business Manager.
ActionTry it
List Promotable Pages
Return one page of Facebook Pages available for promotion from a Meta ad account.
ActionTry it
List Received Audience Sharing Requests
Retrieve a page of received audience sharing requests for a business using the Meta Marketing API. Use it to see requests from other businesses to share custom audiences.
ActionTry it
List Subscribed Apps
List one page of applications subscribed to a Meta ad account.
ActionTry it
List System Users
List one page of system users associated with a Meta Business Manager account, with pagination information when returned.
ActionTry it
List Targeting Search
Tool to search for targeting options in Meta Ads Marketing API. Use when you need to find interests, locations, demographics, schools, or employers for ad targeting purposes.
ActionTry it
List Targeting Suggestions
Return Meta targeting options related to a provider-native seed targeting list for an ad account.
ActionTry it
List User Permissions
Inspect permission names and grant statuses for the connected Meta user, optionally filtered by permission or status.
ActionTry it
List Video Tags
Return one page of TaggableSubject entries from a Video's `/tags` edge. This is video-only: the connected access token must be able to read that Video and its visible tags, so results depend on the video's ownership, privacy, and the token's Page or user permissions.
ActionTry it
List Video Thumbnails
List one page of available thumbnail variants for a Meta video. Use next_cursor to retrieve another page when has_more is true.
ActionTry it
Preview Ad Creative
Retrieve a preview thumbnail URL for an ad creative, with optional thumbnail dimensions.
ActionTry it
Read Ad Sets
Retrieve ad sets from a Meta ad account using the Marketing API. Returns information about the ad sets including their status, targeting, and other properties.
ActionTry it
Rename Ad Object
Rename an existing Meta campaign, ad set, ad, or ad creative.
ActionTry it
Send Conversion Events
Irreversibly submit 1-1,000 validated server conversion events to a Meta Pixel or dataset. A test_event_code routes events to Test Events but does not prevent targeting or measurement side effects; production submission requires explicit confirmation.
ActionTry it
Set Ad Object Status
Set an Ad, Ad Set, or Campaign to ACTIVE or PAUSED, or destructively ARCHIVE or DELETE it. Campaign status changes affect child delivery.
ActionTry it
Start Async Insights Report
Start an asynchronous Meta Ads Insights report for an ad account, campaign, ad set, or ad and return its report-run ID.
ActionTry it
Submit Catalog Item Batch
Submit an asynchronous batch of catalog item create, update, or delete mutations and return its processing handles. DELETE requests permanently remove items from the live catalog, which affects running catalog ads. Requires the catalog_management OAuth scope, which is not granted by default.
ActionTry it
Update Ad Creative
Update the name or status of an ad creative by ID. The tool reports success on an HTTP 200 response.
ActionTry it
Update Ad Set Targeting
Replace the targeting specification of an existing Meta Ad Set.
ActionTry it
Update Ad Study
Update mutable Meta ad-study settings, including replacing its study cells.
ActionTry it
Update Campaign
Update an existing advertising campaign using the Meta Marketing API. Allows modification of campaign properties like name, status, budget, and bidding strategy. Only the fields that need to be updated should be included in the request.
ActionTry it
Upload Ad Image
Upload an image for use in Meta ad creatives using the Marketing API. The image can later be referenced by its hash when creating ad creatives.
ActionTry it
Upsert Catalog Product
Create one Meta catalog product, or explicitly allow updating an item with the same retailer ID, and return its ID. This changes a live catalog item: with allow_upsert it overwrites the existing item. Requires the catalog_management OAuth scope (not granted by default).
ActionTry it
How the Meta Ads integration works
The Meta Ads integration connects your Dench AI CRM directly to Meta Ads, so agents can read and act on your Meta Ads data as part of everyday work — answering questions in chat, keeping your CRM in sync, and running automations without anyone copying data between tools.
101 actions are available for agents to invoke on your behalf. Every call runs through Meta Ads's own authorization, scoped to the account you connect.
Set up Meta Ads in Dench
- 1
Sign in to your Dench workspace and open Integrations.
- 2
Find Meta Ads and click Connect — you'll authorize access through Meta Ads's own sign-in flow. No API keys or code required.
- 3
Ask an agent to use Meta Ads in chat, or call it from an automation.
- 4
Manage or disconnect the connection any time from workspace settings.
Frequently asked questions
How does the Meta Ads integration work with Dench?
The Dench Meta Ads integration connects your AI CRM to Meta Ads, so AI agents can work with your Meta Ads data as part of chats, automations, and CRM workflows. You connect your account once, and every agent in your workspace can use it — governed by your workspace permissions.
What actions can AI agents perform with Meta Ads via Dench?
The Meta Ads integration currently exposes 101 actions, including Copy Ad Object, Create Ad, Create Ad Creative, Create Ad Set, Create Ad Study, and Create Ad Video. Agents invoke them on your behalf from chat or from automations.
Do I need to write code to connect Meta Ads to Dench?
No. You connect Meta Ads from your Dench workspace using Meta Ads's own sign-in and authorization flow — no API keys to copy, no glue code to maintain.
Is the Meta Ads integration secure?
Connections are authorized through Meta Ads's own authentication flow, and Dench stores only the authorization needed to act on your behalf. You can review and disconnect the Meta Ads connection from your workspace settings at any time.