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
- Find the action in the table below, or call
search_one_platform_actions with platform meta if it is not listed.
- 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.
- 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.
withoneai