← Tools Reference

Meta

Meta integration (Marketing, Social). Imported from open-connector.

API key4 toolshttps://graph.facebook.com/{meta_graph_api_version}
GET
meta_get_current_user
Retrieve the current Meta Graph API user for the connected access token.

/me

GET
meta_list_ad_accounts
List Meta ad accounts available to the connected access token.

/me/adaccounts

4 parameters
ParamTypeRequiredDescription
fieldsstringoptionalThe comma-separated Meta fields or list of fields to request.
limitintegeroptionalThe maximum number of records Meta should return.
afterstringoptionalThe Graph API after cursor for requesting the next page.
beforestringoptionalThe Graph API before cursor for requesting the previous page.
GET
meta_list_campaigns
List campaigns under one Meta ad account with optional delivery status filters.

/campaigns

7 parameters
ParamTypeRequiredDescription
adAccountIdstringrequiredThe Meta ad account ID, with or without the act_ prefix.
fieldsstringoptionalThe comma-separated Meta fields or list of fields to request.
limitintegeroptionalThe maximum number of records Meta should return.
afterstringoptionalThe Graph API after cursor for requesting the next page.
beforestringoptionalThe Graph API before cursor for requesting the previous page.
effectiveStatusarrayoptionalA list of Meta delivery statuses.
configuredStatusarrayoptionalA list of Meta delivery statuses.
GET
meta_get_insights
Retrieve Meta Ads insights for an ad account, campaign, ad set, or ad object.

/{objectId}/insights

12 parameters
ParamTypeRequiredDescription
objectIdstringrequiredA Meta Graph API object identifier.
levelstringoptionalThe Meta insights aggregation level.
fieldsstringoptionalThe comma-separated Meta fields or list of fields to request.
datePresetstringoptionalThe Meta insights date preset.
timeRangeobjectoptionalThe custom Meta insights date range.
breakdownsarrayoptionalA list of string values.
filteringarrayoptionalMeta insights filtering expressions forwarded to the Graph API.
sortarrayoptionalA list of string values.
actionAttributionWindowsarrayoptionalA list of string values.
limitintegeroptionalThe maximum number of records Meta should return.
afterstringoptionalThe Graph API after cursor for requesting the next page.
beforestringoptionalThe Graph API before cursor for requesting the previous page.