Meta Ads
ads & conversion 52 tools availableCreate, edit and get insights from ads across Meta technologies, including Facebook, Instagram, Messenger, WhatsApp and more.
About this integration
Connect Meta Ads to Definable to automate repetitive tasks, sync data with the rest of your stack, trigger on real-world events. Personas call Meta Ads's 52 tools directly from chat or scheduled flows. You can wire it into any persona to read, write, and react when an event fires.
Connect Meta Ads to Definable and it becomes a set of typed tools your agents plan with — triggered by events, run on schedules, or invoked mid-conversation. Every write is checked by the verifier before it lands.
Meta Ads · in workflows
What teams actually run.
Three patterns teams run with Meta Ads on day one. Each one is a plain-English prompt — no canvas, no glue code — and you can remix them into anything.
Daily summary
Cross-tool sync
52 tools available
The Meta Ads toolbox.
Every Meta Ads capability your agents can call, each with a typed schema the planner reads. The router picks the right tool per step; the verifier checks the result.
Create Ad Create a new ad within an ad set using the Meta Marketing API. Supports various ad formats including image, video, carousel, and collection ads.
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
Create Ad Set Create a new ad set within a campaign using the Meta Marketing API. Supports detailed targeting options, budgets, and optimization goals.
Create Campaign Create a new advertising campaign using the Meta Marketing API. Supports various campaign objectives, budgets, and bidding strategies.
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.
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.
Get Ad Accounts Tool to retrieve all ad account IDs accessible to the authenticated user from Meta Ads. Use when you need to get a user's ad account information including account IDs, names, and other account details.
Get Ad Creative Get Ad Creative
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.
Get Meta Object Tool to retrieve data for any Meta Marketing API object by its ID. Use when you need to get information about a specific ad account, campaign, ad set, ad, ad creative, page, user, or other Meta object. Supports flexible field selection to retrieve only the data you need.
Get Page Accounts Tool to retrieve permanent page access tokens for accounts managed by the user. Use when you need to get pages the user manages along with access tokens for each page.
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.
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.
List Ad Creatives Tool to list all ad creatives under an ad account. Use when you need to retrieve multiple ad creatives from a Meta Ads account to view, analyze, or manage creative assets.
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.
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.
List Ads Tool to list all ads under an ad account using the Meta Marketing API. Use when you need to retrieve ads from a specific ad account with optional filtering by fields.
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.
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.
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.
List Business Ad Accounts Tool to retrieve all ad accounts owned by a specific Business Manager. Use when you need to get ad account information for a business including account IDs, names, and status.
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.
List Client Ad Accounts Tool to list all client ad accounts accessible to a business from Meta Ads. Use when you need to retrieve ad accounts that have been shared with a Business Manager as clients.
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.
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.
List Client Offsite Signal Container Business Objects Tool to retrieve client offsite signal container business objects for a business from Meta Marketing API. Use when you need to list all client offsite signal container business objects associated with a specific business ID.
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.
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.
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.
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.
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.
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.
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.
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.
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.
List Owned Offsite Signal Container Business Objects Tool to retrieve owned offsite signal container business objects for a business from Meta Marketing API. Use when you need to list all owned offsite signal container business objects associated with a specific business ID.
List Owned Pages Tool to retrieve Pages owned by a Business Manager from Meta Marketing API. Use when you need to get a list of all Facebook Pages that a business owns or manages.
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.
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.
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.
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.
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.
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.
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.
List Received Audience Sharing Requests Tool to retrieve all received audience sharing requests for a business using the Meta Marketing API. Use when you need to see which other businesses have requested to share custom audiences with your business.
List System Users Tool to retrieve system users for a Meta Business Manager account. Use when you need to list all system users (non-human accounts used for API access) associated with a business.
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.
Preview Ad Creative Preview Ad Creative
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.
Update Ad Creative Update Ad Creative
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.
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.
See it run
One prompt, start to finish.
A real prompt, the Meta Ads tools it calls, and what comes back. This is the whole interface — describe the outcome, agents handle the rest.
Run a real Meta Ads task end-to-end — plan it, execute across the API, and hand back a verified result.
metaads.create_ad Create a new ad within an ad set using the Meta Marketing API. Supports various ad formats metaads.create_ad_creative Create a new ad creative using the Meta Marketing API. Ad creatives are reusable visual an metaads.create_ad_set Create a new ad set within a campaign using the Meta Marketing API. Supports detailed targ · verified Done. Meta Ads responded across 3 calls, the verifier signed off, and the result is logged with every payload.
Pairs well with Meta Ads
Connect Meta Ads to your stack with Workflow
AI-native automation between Meta Ads and 80+ other tools — built, run, and self-healed by Workflow.
FAQ · Meta Ads
Questions, answered.
What teams ask before connecting Meta Ads.
01 What can I automate with Meta Ads on Definable?
Anything Meta Ads exposes through its API. Common ads & conversion workflows on Definable include automate repetitive tasks, sync data with the rest of your stack, trigger on real-world events. Personas can call any of the 52 Meta Ads tools directly, then chain the result into another integration without you writing code.
02 How does Meta Ads authentication work?
Meta Ads uses OAUTH2, API_KEY on Definable. You connect once from the integrations page, scoped to the permissions you choose, and from then on any persona that has the integration enabled can act on your behalf. Tokens are encrypted at rest and rotated automatically.
03 Is the Meta Ads integration included in my Definable plan?
Yes — every Definable plan, including Starter, includes access to all 52 Meta Ads tools. You only need a separate Meta Ads subscription if Meta Ads itself charges per seat or per API call.
04 Is using Meta Ads through Definable secure?
Every call from a persona to Meta Ads is logged with the user, persona, prompt, and response. Tokens never leave Definable's secrets vault, scopes are configurable per persona, and you can revoke access at any time from the integration page.
05 How do I get started with Meta Ads on Definable?
Sign up for Definable, open the integrations page, find Meta Ads, and connect via OAuth or API key. You can immediately attach Meta Ads to any persona and start running workflows. The free Starter plan includes 5,000 credits/month.
06 What Meta Ads actions does Definable expose?
Definable exposes all 52 Meta Ads actions as callable tools — including `Create Ad`, `Create Ad Creative`, `Create Ad Set`, plus 49 more. Each tool gets a typed parameter schema so personas know exactly how to call it.
Put Meta Ads to work tonight.
Connect in two clicks, describe an outcome, and your first workflow is live in minutes. Free plan included — no card required.