meta

name

meta

description

Meta builds technologies that help people connect, find communities, and grow businesses. Its ecosystem spans social media, VR/AR platforms, and digital advertising tools used by billions of users. Read and write Meta data through One: ads, customconversions, adcreatives, adsets, adspixel, campaigns and more, 61 actions with real parameter documentation. Use whenever the user asks to look something up in Meta, create or update a record there, or build code against the Meta API.

Meta through One

Meta builds technologies that help people connect, find communities, and grow businesses. Its ecosystem spans social media, VR/AR platforms, and digital advertising tools used by billions of users.

One exposes Meta through four MCP tools. The table below carries real action ids from One's knowledge base, so for a common operation you can skip search and go straight to reading the action's parameters.

How to run an action

1. Find the action in the table below, or call search_one_platform_actions with platform meta if it is not listed.
2. Call get_one_action_knowledge with the action id. Do this every time, including for actions in this table. The table gives you the id, not the parameters.
3. Call execute_one_action with parameters copied from that knowledge.

Never guess a parameter name, a body field, or an enum value. The knowledge has the real schema, and a guessed field is either a 400 or a silent write of the wrong thing.

Before you start

Call list_one_integrations once and confirm Meta is connected. If it is missing, the user has not connected it: say so and point them at https://app.withone.ai rather than reaching for raw HTTP.

Each connection carries an access field. If it reports {"policy": "methods", "methods": ["GET"]} the agent is read-only here, so plan a read-only answer instead of attempting a write that will be refused.

Before a write

Creates, updates, deletes and sends land on a real Meta account and cannot be recalled. State the action and the specific target in one line before the first write in a task, and let the user stop you. Reads need no confirmation.

Actions

Ads

Action	Method	Path	Action id
Get an Ad by ID	GET	/v25.0/{{adId}}	conn_mod_def::GKRjsbyRDLw::X8_Xh1baRueYUh1TK5Lh_w
List an Ad Account's Ads	GET	/v25.0/act_{{adAccountId}}/ads	conn_mod_def::GKRjtAx7Qu0::hM4yPa5RQ6-A3Y_WvPq5mQ
List an Ad Campaign's Ads	GET	/{{adCampaignId}}/ads	conn_mod_def::GKRjuDp3WdU::tXTjMvlgTRymYyXUZnMZiQ
List an Ad Set's Ads	GET	/v25.0/{{adSetId}}/ads	conn_mod_def::GKRju3p-mcw::kwrNYPGGSeOqYbp1yDs80g
Create an Ad in an Ad Account	POST	/v25.0/act_{{adAccountId}}/ads	conn_mod_def::GKRjs-q-OtE::QyASq5pbQvWoPls3FG7D5w
Create an Ad in an Ad Account	POST	/act_{{adAccountId}}/ads	conn_mod_def::GKRjsHq1qOU::sXbCtK7eS_SU7Y3pWkr0mQ
Delete an Ad	DELETE	/{{adId}}	conn_mod_def::GKRjsGOAQxI::xK2s6ytBQnybqjvoU0oY0Q

CustomConversions

Action	Method	Path	Action id
List an Ad Account's Custom Conversions	GET	/act_{{adAccountId}}/customconversions	conn_mod_def::GKRjvQuVNyw::EoRQzGYHTDONAw3HGyzjag
List an Ad Account's Custom Conversions	GET	/v25.0/{{adAccountId}}/customconversions	conn_mod_def::GKRjvaL-8-o::ybuu5eeXS1qqV6JQUBgReQ
Create a Custom Conversion for an Ad Account	POST	/act_{{adAccountId}}/customconversions	conn_mod_def::GKRjvQqGTww::_ejg1UcmTcqogx8h8Zp2Ug
Create a Custom Conversion for an Ad Account	POST	/act_{{adAccountId}}/customconversions	conn_mod_def::GKRjvQgiVCo::VI6x_cDtRgyxR9o2-OToVA
Delete a Custom Conversion	DELETE	/{{customConversionId}}	conn_mod_def::GKRjvQG5lsA::YxLOvTr9RmWthje4bF49pw
Update a Custom Conversion	POST	/{{customConversionId}}	conn_mod_def::GKRjvSXenFk::ZEpHg55QQa2ooVwfPxc0Pw

AdCreatives

Action	Method	Path	Action id
Get an Ad Creative's Previews	GET	/v25.0/{{creativeId}}/previews	conn_mod_def::GKRjutIWCc0::f9ASPZuXSWqsg5ZKdickYA
Get an Ad Set's Ad Creatives	GET	/v25.0/{{adSetId}}/adcreatives	conn_mod_def::GKRju2FS8Yo::IRDpKUCiTTaIU9qfKoKsXw
List an Ad Account's Ad Creatives	GET	/v25.0/act_{{adAccountId}}/adcreatives	conn_mod_def::GKRjs2dGZiU::gbNWM1y4T-OxgK3Xz2pV_A
List an Ad's Ad Creatives	GET	/v25.0/{{adId}}/adcreatives	conn_mod_def::GKRjsHT_cd0::Rwed1Lp0SgClVcba7XB7vw
Create an Ad Account Ad Creative	POST	/act_{{adAccountId}}/adcreatives	conn_mod_def::GKRjs2B1X1c::CpfvED1SQQyLNqtRzjJQUA

AdSets

Action	Method	Path	Action id
Get an Ad Set	GET	/v25.0/{{adSetId}}	conn_mod_def::GKRjuq3L49g::rgoSrAOjRQmqi6dBQo4F-Q
List an Ad Account's Ad Sets	GET	/v25.0/act_{{adAccountId}}/adsets	conn_mod_def::GKRjtA75d28::X1WyjBOGRS-WJObKSRAgVQ
Create an Ad Account's Ad Set	POST	/v25.0/act_{{adAccountId}}/adsets	conn_mod_def::GKRjtItg_Vg::1fC_0mNKRdW3CEGLZ6Y_uQ
Create an Ad Set for an Ad Account	POST	/act_{{adAccountId}}/adsets	conn_mod_def::GKRjupKqPAc::rBMPuxbbSkqYMveJO8uIlg

AdsPixel

Action	Method	Path	Action id
Get an Ads Pixel	GET	/v25.0/{{adsPixelId}}	conn_mod_def::GKRjvIAkZY4::rFdGI0q2RyWD7RLuat8T7Q
Get an Ads Pixel	GET	/v25.0/{{pixelId}}	conn_mod_def::GKRjvIEbLLc::SssOjuZASUeY8wQrHHnceA
Update an Ads Pixel	POST	/{{adsPixelId}}	conn_mod_def::GKRjvIXIzi8::g0cgyEjmT-ucKBm1N4pVaQ

Campaigns

Action	Method	Path	Action id
Get an Ad Account's Campaigns	GET	/v25.0/act_{{adAccountId}}/campaigns	conn_mod_def::GKRjtkpaKrA::AfnwDGdzTOK2XVw71lDpMw
Create an Ad Campaign for an Ad Account	POST	/act_{{adAccountId}}/campaigns	conn_mod_def::GKRjtu7AsjY::2x_M5XeVSpOvswvbLq67YA
Delete an Ad Campaign	DELETE	/act_{{adAccountId}}/campaigns	conn_mod_def::GKRjtwNcMdY::MMQ-eTX2TGml8PKW11VF9w

AdImages

Action	Method	Path	Action id
List an Ad Account's Ad Images	GET	/v25.0/{{adAccountId}}/adimages	conn_mod_def::GKRjtBkFq7c::Z8-kZCSWS_OteX-lCJEP3w
Create an Ad Account Ad Image	POST	/act_{{adAccountId}}/adimages	conn_mod_def::GKRjs2LTpnw::BTpA7mzJSSiZ1R0ETSZFLg
Delete an Ad Account Ad Image	DELETE	/act_{{adAccountId}}/adimages	conn_mod_def::GKRjs2bpTNU::itP27CpzTQau4wa0w07hvw

AdCreative

Action	Method	Path	Action id
Get an Ad Creative	GET	/v25.0/{{creativeId}}	conn_mod_def::GKRjuDxrabk::srCvdRNPS72UWTkJPgSFiQ
Delete an Ad Creative	DELETE	/{{adCreativeId}}	conn_mod_def::GKRjuBDd4pE::CeiA0j6CRKKfYjROMcfv2A
Update an Ad Creative	POST	/{{adCreativeId}}	conn_mod_def::GKRjunroeyA::ENVBk-w5RZmKS6aycfZOng

AdCampaign

Action	Method	Path	Action id
Get an Ad Campaign	GET	/{{campaignId}}	conn_mod_def::GKRjtv0Sd4I::goSRTv4IRBO7WEJKHcvXZA
Update an Ad Campaign	POST	/{{campaignId}}	conn_mod_def::GKRjtvMjGD0::emHzvzuWRJSeGqJel4Qt2w

AdSetInsights

Action	Method	Path	Action id
Get Ad Set Insights	GET	/v25.0/{{adSetId}}/insights	conn_mod_def::GKRjtmKNZ94::lw4-ZiXBROyCwJH0TM_uFg
Get an Ad Set's Insights	GET	/v25.0/{{adSetId}}/insights	conn_mod_def::GKRju8WDVxI::GkVWvsgxTUqgP89JMDQRjw

AdAccounts

Action	Method	Path	Action id
Create an Ad Account for a Business	POST	/{{businessId}}/adaccount	conn_mod_def::GKRjslcQ770::Nl161vuAT76pzA6Sa0c0rg
Update an Ad Account	POST	/act_{{adAccountId}}	conn_mod_def::GKRjs1tp3Dg::8qTbyc0fT4-Fz4eqoL5E8Q

AdsPixels

Action	Method	Path	Action id
Create an Ad Account's Ads Pixel	POST	/act_{{adAccountId}}/adspixels	conn_mod_def::GKRjvInn3Dg::EKsyDdiRR9CcQBeT1gkzUA
Create an Ad Account's Ads Pixel	POST	/act_{{adAccountId}}/adspixels	conn_mod_def::GKRjvH6akaY::iGDeWH4UR62NLHCPo-fneA

AdSet

Action	Method	Path	Action id
Delete an Ad Set	DELETE	/{{adSetId}}/	conn_mod_def::GKRjuoPTo1w::PH8kokxhSMGN683LMwMBoQ

AdAccount

Action	Method	Path	Action id
Get an Ad Account	GET	/act_{{adAccountId}}	conn_mod_def::GKRjslOV51Q::-7D8kAo3TNGrj1rrZ6GhKg

AdSetsInsights

Action	Method	Path	Action id
Get an Ad Set's Insights	GET	/v25.0/{{adSetId}}/insights	conn_mod_def::GKRjstPUYO8::hYOUhUt8QyOTIpenLf4zaQ

AdAccountVideos

Action	Method	Path	Action id
Create an Ad Account Video	POST	/act_{{adAccountId}}/advideos	conn_mod_def::GKRjtRsW_dY::-DzRZc5aRdCUjqK0XPw4fQ

Campaign

Action	Method	Path	Action id
Create an Ad Account Campaign	POST	/v25.0/act_{{adAccountId}}/campaigns	conn_mod_def::GKRjtSKC8xo::Ksa89qY2RD2uKR7C1RsQ_w

AdCampaignInsightsReportRun

Action	Method	Path	Action id
Create Ad Campaign Insights Report Run	POST	/{{campaignId}}/insights	conn_mod_def::GKRjuJuTIlM::xk1yq9W8Ta2bhFBW6u9vWQ

AsyncAdRequestSets

Action	Method	Path	Action id
Create an Ad Account Async Ad Request Set	POST	/act_{{adAccountId}}/asyncadrequestsets	conn_mod_def::GKRjtRsz-rg::0f-GsL5QRla4GKdRdUHePA

CustomAudiences

Action	Method	Path	Action id
List an Ad Account's Custom Audiences	GET	/v25.0/act_{{adAccountId}}/customaudiences	conn_mod_def::GKRjtd2eu5o::P2jlSHeVTN-fFa7ph8NLpg

AdPreviews

Action	Method	Path	Action id
Get Ad Previews for an Ad	GET	/v25.0/{{adId}}/previews	conn_mod_def::GKRjspcpp_w::Bs5S_EvBTEW5V2SpkgmVzw

AdReportRun

Action	Method	Path	Action id
Create an Ad Account Insights Report Run	POST	/act_{{adAccountId}}/insights	conn_mod_def::GKRjtj77d1E::y-KLC2foSmmccNlEpuDwHA

AdInsightsReportRuns

Action	Method	Path	Action id
Create Ad Insights Report Run for an Ad	POST	/{{adId}}/insights	conn_mod_def::GKRjsRejG3o::D8ohE6Z1QgmMUbk3eqigFg

AdSetInsightsReportRun

Action	Method	Path	Action id
Create an Ad Set Insights Report Run	POST	/{{adSetId}}/insights	conn_mod_def::GKRju_4lHKw::Bo4u94RxTJ2-9RF6xCLS1g

AdSetCampaignInsights

Action	Method	Path	Action id
Get an Ad Set's Campaign Insights	GET	/v25.0/{{adSetId}}/insights	conn_mod_def::GKRjufY5WX4::u1yZrxTiQjOW9sErp3ESaA

AdAccountCampaigns

Action	Method	Path	Action id
Delete Ad Account Campaigns	DELETE	/act_{{adAccountId}}/campaigns	conn_mod_def::GKRjtbi-fGc::Oh02yHYpQmyIrdrQ_bv6ng

AdAccountAsyncBatchRequests

Action	Method	Path	Action id
Create an Ad Account Async Batch Request	POST	/act_{{adAccountId}}/async_batch_requests	conn_mod_def::GKRjtRmTucg::iJk4umV3SCuAf0gcMQQ_Ag

AdsPixelSharedAccounts

Action	Method	Path	Action id
Delete an Ad Account Association from an Ads Pixel or Custom Audience	DELETE	/{{adsPixelId}}/shared_accounts	conn_mod_def::GKRjsntoIC8::aypDqcQ-QZGy7rEoykrF4Q

AdSetActivities

Action	Method	Path	Action id
Get an Ad Set's Activities	GET	/{{adSetId}}/activities	conn_mod_def::GKRju4Se78k::WZiUH735SMiBpUQlCzxjsw

AdAccountUser

Action	Method	Path	Action id
Get an Ad Account User	GET	/v25.0/act_{{adAccountId}}	conn_mod_def::GKRjt5JPobs::HYKScLRbSb6lDhnaXRnbKg

AdVideos

Action	Method	Path	Action id
Delete an Ad Account's Ad Videos	DELETE	/act_{{adAccountId}}/advideos	conn_mod_def::GKRjtR4GH6g::pKCdYT-RRby6p28vf3haGw

When a call fails

The error comes from Meta, not from One. A 400 or 422 means your parameters do not match the schema, so re-read the knowledge and fix the field. A 401 or 403 means the connection needs re-authorizing, which no retry will fix. A 404 means the id is not on this account. A 429 means slow down. Never retry a write more than once: the first attempt may have landed.

Full catalog: https://www.withone.ai/knowledge/meta

Integration knowledge by One (withone.ai), licensed under One-Knowledge-1.0. Attribution must be preserved in derivative works.