OXYGENOXYGEN
← All integrations
Meta Ads logo

Meta Ads

Read Facebook and Instagram ad data.

AdsAPI key52 endpoints

Endpoints

OperationMethod & pathEffectLatencyRateCost
METAADS_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.
POST /composio/metaads/metaads_create_adexternal_sendmanaged
METAADS_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
POST /composio/metaads/metaads_create_ad_creativeexternal_sendmanaged
METAADS_CREATE_AD_SET
Create a new ad set within a campaign using the Meta Marketing API. Supports detailed targeting options, budgets, and optimization goals.
POST /composio/metaads/metaads_create_ad_setexternal_sendmanaged
METAADS_CREATE_CAMPAIGN
Create a new advertising campaign using the Meta Marketing API. Supports various campaign objectives, budgets, and bidding strategies.
POST /composio/metaads/metaads_create_campaignexternal_sendmanaged
METAADS_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.
POST /composio/metaads/metaads_create_custom_audienceexternal_sendmanaged
METAADS_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.
POST /composio/metaads/metaads_delete_campaignexternal_sendmanaged
METAADS_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 /composio/metaads/metaads_get_ad_accountsnonemanaged
METAADS_GET_AD_CREATIVE
Get Ad Creative
GET /composio/metaads/metaads_get_ad_creativenonemanaged
METAADS_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 /composio/metaads/metaads_get_insightsnonemanaged
METAADS_GET_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 /composio/metaads/metaads_get_objectnonemanaged
METAADS_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 /composio/metaads/metaads_get_page_accountsnonemanaged
METAADS_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 /composio/metaads/metaads_get_usernonemanaged
METAADS_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.
GET /composio/metaads/metaads_get_videononemanaged
METAADS_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.
GET /composio/metaads/metaads_list_ad_creativesnonemanaged
METAADS_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.
GET /composio/metaads/metaads_list_ad_network_analyticsnonemanaged
METAADS_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.
GET /composio/metaads/metaads_list_ad_network_analytics_resultsnonemanaged
METAADS_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.
GET /composio/metaads/metaads_list_adsnonemanaged
METAADS_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.
GET /composio/metaads/metaads_list_agenciesnonemanaged
METAADS_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.
GET /composio/metaads/metaads_list_assigned_pagesnonemanaged
METAADS_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.
GET /composio/metaads/metaads_list_assigned_usersnonemanaged
METAADS_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.
GET /composio/metaads/metaads_list_business_ad_accountsnonemanaged
METAADS_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.
GET /composio/metaads/metaads_list_business_invoicesnonemanaged
METAADS_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.
GET /composio/metaads/metaads_list_client_ad_accountsnonemanaged
METAADS_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.
GET /composio/metaads/metaads_list_client_appsnonemanaged
METAADS_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.
GET /composio/metaads/metaads_list_client_instagram_assetsnonemanaged
METAADS_LIST_CLIENT_OFFSITE_SIGNAL_CONTAINERS
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.
GET /composio/metaads/metaads_list_client_offsite_signal_containersnonemanaged
METAADS_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.
GET /composio/metaads/metaads_list_client_pagesnonemanaged
METAADS_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.
GET /composio/metaads/metaads_list_clientsnonemanaged
METAADS_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.
GET /composio/metaads/metaads_list_collaborative_ads_collaboration_requestsnonemanaged
METAADS_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.
GET /composio/metaads/metaads_list_collaborative_ads_suggested_partnersnonemanaged
METAADS_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.
GET /composio/metaads/metaads_list_initiated_audience_sharing_requestsnonemanaged
METAADS_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.
GET /composio/metaads/metaads_list_managed_partner_ads_funding_source_detailsnonemanaged
METAADS_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.
GET /composio/metaads/metaads_list_owned_appsnonemanaged
METAADS_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.
GET /composio/metaads/metaads_list_owned_businessesnonemanaged
METAADS_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.
GET /composio/metaads/metaads_list_owned_instagram_assetsnonemanaged
METAADS_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.
GET /composio/metaads/metaads_list_owned_offsite_signal_container_business_objectsnonemanaged
METAADS_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.
GET /composio/metaads/metaads_list_owned_pagesnonemanaged
METAADS_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.
GET /composio/metaads/metaads_list_pending_client_ad_accountsnonemanaged
METAADS_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.
GET /composio/metaads/metaads_list_pending_client_appsnonemanaged
METAADS_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.
GET /composio/metaads/metaads_list_pending_client_pagesnonemanaged
METAADS_LIST_PENDING_OFFSITE_SIGNAL_CONTAINERS
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.
GET /composio/metaads/metaads_list_pending_offsite_signal_containersnonemanaged
METAADS_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.
GET /composio/metaads/metaads_list_pending_owned_ad_accountsnonemanaged
METAADS_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.
GET /composio/metaads/metaads_list_pending_owned_pagesnonemanaged
METAADS_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.
GET /composio/metaads/metaads_list_pending_usersnonemanaged
METAADS_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.
GET /composio/metaads/metaads_list_received_audience_sharing_requestsnonemanaged
METAADS_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.
GET /composio/metaads/metaads_list_system_usersnonemanaged
METAADS_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.
GET /composio/metaads/metaads_list_targeting_searchnonemanaged
METAADS_PREVIEW_AD_CREATIVE
Preview Ad Creative
POST /composio/metaads/metaads_preview_ad_creativeexternal_sendmanaged
METAADS_READ_ADSETS
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.
GET /composio/metaads/metaads_read_adsetsnonemanaged
METAADS_UPDATE_AD_CREATIVE
Update Ad Creative
POST /composio/metaads/metaads_update_ad_creativeexternal_sendmanaged
METAADS_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.
POST /composio/metaads/metaads_update_campaignexternal_sendmanaged
METAADS_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.
POST /composio/metaads/metaads_upload_ad_imageexternal_sendmanaged