- Category: ads & conversion
- Auth: OAUTH2, API_KEY
- Composio-managed OAuth available? No
- Tools: 95
- Triggers: 0
- Slug:
METAADS - Version: 20261103_00
Tools
Copy Ad Object
Copy Ad Object
METAADS_COPY_AD_OBJECTCopy a Meta Campaign, Ad Set, or Ad while explicitly selecting its resource type and supported copy options.Input Parameters
Output
Create Ad
Create Ad
Create Ad Creative
Create Ad Creative
METAADS_CREATE_AD_CREATIVECreate 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 policiesInput Parameters
Output
Create Ad Set
Create Ad Set
METAADS_CREATE_AD_SETCreate a new ad set within a campaign using the Meta Marketing API. Supports detailed targeting options, budgets, and optimization goals.Input Parameters
Output
Create Ad Study
Create Ad Study
METAADS_CREATE_AD_STUDYCreate a Meta A/B test or other ad study under a business, including its cells and tested ad entities.Input Parameters
Output
Create Ad Video
Create Ad Video
METAADS_CREATE_AD_VIDEOUpload an ad video asset; Meta may keep processing it after returning its ID.Input Parameters
Output
Create Campaign
Create Campaign
METAADS_CREATE_CAMPAIGNCreate a new advertising campaign using the Meta Marketing API. Supports various campaign objectives, budgets, and bidding strategies.Input Parameters
Output
Create Custom Audience
Create Custom Audience
METAADS_CREATE_CUSTOM_AUDIENCECreate a new custom audience using the Meta Marketing API. Supports various types of custom audiences including customer lists, website visitors, and app users.Input Parameters
Output
Create Custom Conversion
Create Custom Conversion
METAADS_CREATE_CUSTOM_CONVERSIONCreate 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.Input Parameters
Output
Create Lead Form
Create Lead Form
METAADS_CREATE_LEAD_FORMCreate 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.Input Parameters
Output
Delete Ad Object
Delete Ad Object
METAADS_DELETE_AD_OBJECTDelete 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.Input Parameters
Output
Delete Campaign
Delete Campaign
Estimate Ad Delivery
Estimate Ad Delivery
METAADS_ESTIMATE_AD_DELIVERYEstimate monthly audience delivery for targeting and optimization settings in a Meta ad account.Input Parameters
Output
Estimate Targeting Reach
Estimate Targeting Reach
METAADS_ESTIMATE_TARGETING_REACHEstimate 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.Input Parameters
Output
Generate Ad Previews
Generate Ad Previews
METAADS_GENERATE_AD_PREVIEWSRender previews for a provider-native creative specification in a Meta ad account and return the generated HTML bodies.Input Parameters
Output
Get Ad Accounts
Get Ad Accounts
METAADS_GET_AD_ACCOUNTSRetrieve one page of directly assigned ad accounts for the authenticated user, including account IDs, names, and other requested account details.Input Parameters
Output
Get Ad Preview
Get Ad Preview
METAADS_GET_AD_PREVIEWRender a placement-specific preview for an existing Meta Ad or Ad Creative.Input Parameters
Output
Get Ad Study
Get Ad Study
Get Current Meta App
Get Current Meta App
Get Insights
Get Insights
METAADS_GET_INSIGHTSGet 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.Input Parameters
object_id (e.g., ‘account’ for ‘act_…’ IDs, ‘campaign’ for campaign IDs, ‘adset’ for ad set IDs, ‘ad’ for ad IDs); mismatches return empty or misleading metrics. Allowed values: ‘account’, ‘campaign’, ‘adset’, ‘ad’.since and until in YYYY-MM-DD format (e.g., {‘since’: ‘2024-01-01’, ‘until’: ‘2024-01-31’}). Never provide both time_range and date_preset simultaneously.[7d_click] to match Meta’s unified attribution default; add VIEW_1D/CLICK_28D/etc. explicitly if you need legacy multi-window behavior. Different window values yield significantly different conversion counts; use consistent windows when comparing across campaigns or time periods.Output
Get Multiple Meta Objects
Get Multiple Meta Objects
METAADS_GET_MULTIPLE_OBJECTSRetrieve 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.Input Parameters
Output
Get Meta Object
Get Meta Object
METAADS_GET_OBJECTRetrieve 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.Input Parameters
Output
Get Page Accounts
Get Page Accounts
METAADS_GET_PAGE_ACCOUNTSRetrieve 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.Input Parameters
Output
Get Pixel Event Stats
Get Pixel Event Stats
METAADS_GET_PIXEL_EVENT_STATSRead recent Pixel event-count and processing statistics, optionally restricted to server events and one event name, to verify aggregate ingestion.Input Parameters
Output
Get User
Get User
METAADS_GET_USERTool 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.Input Parameters
Output
Get Video
Get Video
METAADS_GET_VIDEODEPRECATED: 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.Input Parameters
Output
List Activities
List Activities
METAADS_LIST_ACTIVITIESList activity history for a Meta ad account or ad set.Input Parameters
Output
List Ad Account Pixels
List Ad Account Pixels
METAADS_LIST_AD_ACCOUNT_PIXELSList the Pixels and consolidated datasets associated with an ad account so a usable data-source ID can be selected for Conversions API events.Input Parameters
Output
List Ad Account Recommendations
List Ad Account Recommendations
METAADS_LIST_AD_ACCOUNT_RECOMMENDATIONSReturn one page of Meta recommendations for an advertising account.Input Parameters
Output
List Ad Creatives
List Ad Creatives
METAADS_LIST_AD_CREATIVESList one page of ad creatives under a Meta Ads account to view or analyze creative assets.Input Parameters
Output
List Ad Images
List Ad Images
METAADS_LIST_AD_IMAGESList one page of image assets in a Meta ad account, optionally restricted to exact image hashes.Input Parameters
Output
List Ad Network Analytics
List Ad Network Analytics
List Ad Network Analytics Results
List Ad Network Analytics Results
METAADS_LIST_AD_NETWORK_ANALYTICS_RESULTSTool 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.Input Parameters
Output
List Ad Rule History
List Ad Rule History
METAADS_LIST_AD_RULE_HISTORYReturn one page of historical changes and executions for a Meta Automated Rule. Use next_cursor to retrieve another page when has_more is true.Input Parameters
Output
List Ads
List Ads
METAADS_LIST_ADSList a page of ads under a Meta ad account, with optional selection of returned fields.Input Parameters
Output
List Ad Studies
List Ad Studies
METAADS_LIST_AD_STUDIESList one page of A/B tests and other ad studies owned by a Meta business, including projected cells.Input Parameters
Output
List Ad Videos
List Ad Videos
METAADS_LIST_AD_VIDEOSList one page of video assets in a Meta ad account, optionally filtered by title, dimensions, duration, or aspect ratio.Input Parameters
Output
List Agencies
List Agencies
METAADS_LIST_AGENCIESTool 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.Input Parameters
Output
List Assigned Pages
List Assigned Pages
METAADS_LIST_ASSIGNED_PAGESTool 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.Input Parameters
Output
List Assigned Users
List Assigned Users
METAADS_LIST_ASSIGNED_USERSTool 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.Input Parameters
Output
List Business Ad Accounts
List Business Ad Accounts
METAADS_LIST_BUSINESS_AD_ACCOUNTSRetrieve a page of ad accounts owned by a specific Business Manager, including account IDs, names, and status.Input Parameters
Output
List Businesses
List Businesses
METAADS_LIST_BUSINESSESList a page of Business Managers accessible to the authenticated Meta principal via /me/businesses. Requires the business_management permission on the connected token.Input Parameters
paging.cursors.after value from a previous response to fetch the next page.Output
List Business Invoices
List Business Invoices
METAADS_LIST_BUSINESS_INVOICESTool 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.Input Parameters
int.Output
List Business Users
List Business Users
List Campaigns
List Campaigns
METAADS_LIST_CAMPAIGNSList one page of campaigns belonging to a Meta ad account.Input Parameters
Output
List Catalog Products
List Catalog Products
METAADS_LIST_CATALOG_PRODUCTSReturn one filtered page of products from a Meta product catalog.Input Parameters
Output
List Catalog Product Sets
List Catalog Product Sets
METAADS_LIST_CATALOG_PRODUCT_SETSReturn one filtered page of product sets from a Meta product catalog.Input Parameters
Output
List Client Ad Accounts
List Client Ad Accounts
METAADS_LIST_CLIENT_AD_ACCOUNTSList one page of client ad accounts shared with a Meta Business Manager.Input Parameters
Output
List Client Apps
List Client Apps
List Client Instagram Assets
List Client Instagram Assets
METAADS_LIST_CLIENT_INSTAGRAM_ASSETSTool 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.Input Parameters
Output
List Client Offsite Signal Container Business Objects
List Client Offsite Signal Container Business Objects
METAADS_LIST_CLIENT_OFFSITE_SIGNAL_CONTAINERSRetrieve one page of client offsite signal container business objects for a business using the Meta Marketing API.Input Parameters
Output
List Client Pages
List Client Pages
METAADS_LIST_CLIENT_PAGESTool 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.Input Parameters
Output
List Clients
List Clients
METAADS_LIST_CLIENTSTool 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.Input Parameters
Output
List Collaborative Ads Collaboration Requests
List Collaborative Ads Collaboration Requests
METAADS_LIST_COLLABORATIVE_ADS_COLLABORATION_REQUESTSTool 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.Input Parameters
Output
List Collaborative Ads Suggested Partners
List Collaborative Ads Suggested Partners
METAADS_LIST_COLLABORATIVE_ADS_SUGGESTED_PARTNERSTool 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.Input Parameters
Output
List Comments
List Comments
METAADS_LIST_COMMENTSReturn 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.Input Parameters
toplevel returns top-level comments; stream returns all levels in chronological order.Output
List Custom Audiences
List Custom Audiences
METAADS_LIST_CUSTOM_AUDIENCESList one page of custom audiences in a Meta ad account, with field projection and optional business, primary-audience, or Pixel constraints.Input Parameters
Output
List Custom Conversions
List Custom Conversions
METAADS_LIST_CUSTOM_CONVERSIONSList one page of custom-conversion definitions in a Meta ad account, with field projection and opaque cursor pagination.Input Parameters
Output
List Initiated Audience Sharing Requests
List Initiated Audience Sharing Requests
METAADS_LIST_INITIATED_AUDIENCE_SHARING_REQUESTSTool 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.Input Parameters
Output
List Leads
List Leads
METAADS_LIST_LEADSList one page of leads belonging to a Meta Ad or Leadgen Form.Input Parameters
Output
List Managed Partner Ads Funding Source Details
List Managed Partner Ads Funding Source Details
METAADS_LIST_MANAGED_PARTNER_ADS_FUNDING_SOURCE_DETAILSTool 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.Input Parameters
Output
List Owned Apps
List Owned Apps
List Owned Businesses
List Owned Businesses
METAADS_LIST_OWNED_BUSINESSESTool 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.Input Parameters
Output
List Owned Instagram Assets
List Owned Instagram Assets
METAADS_LIST_OWNED_INSTAGRAM_ASSETSTool 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.Input Parameters
Output
List Owned Offsite Signal Container Business Objects
List Owned Offsite Signal Container Business Objects
METAADS_LIST_OWNED_OFFSITE_SIGNAL_CONTAINER_BUSINESS_OBJECTSRetrieve one page of owned offsite signal container business objects associated with a specific business ID from the Meta Marketing API.Input Parameters
Output
List Owned Pages
List Owned Pages
METAADS_LIST_OWNED_PAGESRetrieve a page of Facebook Pages owned by a Business Manager from the Meta Marketing API.Input Parameters
Output
List Owned Product Catalogs
List Owned Product Catalogs
METAADS_LIST_OWNED_PRODUCT_CATALOGSReturn one page of product catalogs owned by a Meta Business Manager.Input Parameters
Output
List Pending Client Ad Accounts
List Pending Client Ad Accounts
METAADS_LIST_PENDING_CLIENT_AD_ACCOUNTSTool 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.Input Parameters
Output
List Pending Client Apps
List Pending Client Apps
METAADS_LIST_PENDING_CLIENT_APPSTool 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.Input Parameters
Output
List Pending Client Pages
List Pending Client Pages
METAADS_LIST_PENDING_CLIENT_PAGESTool 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.Input Parameters
Output
List Pending Owned Ad Accounts
List Pending Owned Ad Accounts
METAADS_LIST_PENDING_OWNED_AD_ACCOUNTSTool 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.Input Parameters
Output
List Pending Owned Pages
List Pending Owned Pages
METAADS_LIST_PENDING_OWNED_PAGESTool 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.Input Parameters
Output
List Pending Users
List Pending Users
METAADS_LIST_PENDING_USERSTool 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.Input Parameters
Output
List Promotable Pages
List Promotable Pages
METAADS_LIST_PROMOTABLE_PAGESReturn one page of Facebook Pages available for promotion from a Meta ad account.Input Parameters
Output
List Received Audience Sharing Requests
List Received Audience Sharing Requests
METAADS_LIST_RECEIVED_AUDIENCE_SHARING_REQUESTSRetrieve 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.Input Parameters
Output
List Subscribed Apps
List Subscribed Apps
METAADS_LIST_SUBSCRIBED_APPSList one page of applications subscribed to a Meta ad account.Input Parameters
Output
List System Users
List System Users
METAADS_LIST_SYSTEM_USERSList one page of system users associated with a Meta Business Manager account, with pagination information when returned.Input Parameters
Output
List Targeting Search
List Targeting Search
METAADS_LIST_TARGETING_SEARCHTool 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.Input Parameters
Output
List Targeting Suggestions
List Targeting Suggestions
METAADS_LIST_TARGETING_SUGGESTIONSReturn Meta targeting options related to a provider-native seed targeting list for an ad account.Input Parameters
Output
List User Permissions
List User Permissions
List Video Thumbnails
List Video Thumbnails
METAADS_LIST_VIDEO_THUMBNAILSList one page of available thumbnail variants for a Meta video. Use next_cursor to retrieve another page when has_more is true.Input Parameters
Output
Preview Ad Creative
Preview Ad Creative
METAADS_PREVIEW_AD_CREATIVERetrieve a preview thumbnail URL for an ad creative, with optional thumbnail dimensions.Input Parameters
Output
Read Ad Sets
Read Ad Sets
METAADS_READ_ADSETSRetrieve ad sets from a Meta ad account using the Marketing API. Returns information about the ad sets including their status, targeting, and other properties.Input Parameters
Output
Rename Ad Object
Rename Ad Object
Send Conversion Events
Send Conversion Events
METAADS_SEND_CONVERSION_EVENTSIrreversibly 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.Input Parameters
Output
Set Ad Object Status
Set Ad Object Status
METAADS_SET_AD_OBJECT_STATUSSet an Ad, Ad Set, or Campaign to ACTIVE or PAUSED, or destructively ARCHIVE or DELETE it. Campaign status changes affect child delivery.Input Parameters
Output
Start Async Insights Report
Start Async Insights Report
METAADS_START_ASYNC_INSIGHTS_REPORTStart an asynchronous Meta Ads Insights report for an ad account, campaign, ad set, or ad and return its report-run ID.Input Parameters
Output
Update Ad Creative
Update Ad Creative
METAADS_UPDATE_AD_CREATIVEUpdate the name or status of an ad creative by ID. The tool reports success on an HTTP 200 response.Input Parameters
Output
Update Ad Set Targeting
Update Ad Set Targeting
Update Ad Study
Update Ad Study
METAADS_UPDATE_AD_STUDYUpdate mutable Meta ad-study settings, including replacing its study cells.Input Parameters
Output
Update Campaign
Update Campaign
METAADS_UPDATE_CAMPAIGNUpdate 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.Input Parameters
Output
Upload Ad Image
Upload Ad Image
METAADS_UPLOAD_AD_IMAGEUpload 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.