withoneai Benchmark Email through One
Benchmark Email is an intuitive email-marketing platform that enables marketers to design mobile-responsive campaigns with drag-and-drop ease, segment contacts for targeted sends, and track real-time engagement metrics to optimize performance.
One exposes Benchmark Email 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_actionswith platformbenchmark-emailif it is not listed. - Call
get_one_action_knowledgewith 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_actionwith 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 Benchmark Email 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 Benchmark Email 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
Emails
| Action | Method | Path | Action id |
|---|---|---|---|
| Download an Email Report (by Email ID and Report Type) | GET | /Emails/{{id}}/{{rType}}/Report/Download |
conn_mod_def::GJ0HsiDNh20::MttbmUJOTSK1aDnh446xiA |
| Get an Email’s AB Split Details | GET | /Emails/{{id}}/ABSplit |
conn_mod_def::GJ0HqrzmbUE::o1lSCi-BRVWJIzls5Pz3Ow |
| Get an Email’s Abuse Campaign Report | GET | /Emails/{{id}}/Report/AbuseCampaign |
conn_mod_def::GJ0HpNEL1C4::4eN-mG5aTNOIW-9hUX6OTg |
| Get an Email’s Bounces Report | GET | /Emails/{{id}}/Report/Bounces |
conn_mod_def::GJ0Hpk4Qq8U::ceE1UutxSAGVFhOTeRnikw |
| Get an Email’s Click Heat Map | GET | /Emails/{{id}}/Report/Click/HeatMap |
conn_mod_def::GJ0Hp4mzXX4::ndGSjvWDQJKD5hlb94JT3w |
| Get an Email’s Click Performance Details | GET | /Emails/{{id}}/Report/ClickPerformance/Details |
conn_mod_def::GJ0HqMNDk6s::7KS3FcPBQwqU8UsnVKSR1g |
| Get an Email’s Click Performance Report | GET | /Emails/{{id}}/Report/ClickPerformance |
conn_mod_def::GJ0HqAWM4aY::0083Hd3iQFKwHB5PcHvyQQ |
| Get an Email’s Clicks Report | GET | /Emails/{{id}}/Report/Clicks |
conn_mod_def::GJ0HqTojNrI::LN0OQ8mRTt6CFRLelRFtDA |
| Get an Email’s Details | GET | /Emails/{{id}} |
conn_mod_def::GJ0HqyqJtEI::xs52lzsAQA-B-TJL_B38ow |
| Get an Email’s Forwards Report | GET | /Emails/{{id}}/Report/Forwards |
conn_mod_def::GJ0HrKvmhyI::V-p44Z8nTpOeYHhoFrepqQ |
| Get an Email’s Hourly Opens Report | GET | /Emails/{{id}}/Report/Opens/Hourly |
conn_mod_def::GJ0HrjPKPog::zzbtvp71QMuHjcyKnvj6dA |
| Get an Email’s Link Detail | GET | /Emails/{{id}}/LinkDetail |
conn_mod_def::GJ0Hrb1rbtg::HD_PAEivQgKhcO-jDKj2ow |
32 more Emails actions are available through search.
Contacts
| Action | Method | Path | Action id |
|---|---|---|---|
| Compare Contacts Across Lists | GET | /Contact/{{listIDs}}/Compare |
conn_mod_def::GJ0HeW1OYY8::EcsyM3msSpGw2fC0gxL0hA |
| Get a Contact List’s Clean Count | GET | /Contact/{{listId}}/CleanCount |
conn_mod_def::GJ0HlBp2Xoc::GgZZoIEVRw2sBCMPWsALlw |
| Get a Contact List’s Contact Summary | GET | /Contact/{{listId}}/ContactSummary |
conn_mod_def::GJ0HlI3sPxw::5qUVdzHJRUSxVUk0B31xcg |
| Get a Contact's Report History | GET | /Contact/{{eMailID}}/ContactReportHistory |
conn_mod_def::GJ0HiCx0wrc::04jRMFhkRhK96aGXZr4RVA |
| Get a List Contact’s Details | GET | /Contact/{{listId}}/ContactDetails/{{id}} |
conn_mod_def::GJ0Hh4OqBhY::G1MlbPPXTVi-qhvyxdldBw |
| Get Active Contact Count | GET | /Contact/ActiveCount |
conn_mod_def::GJ0HhWlyb7I::6k1e7B3dQiicAzr8mtRwpg |
| Get Contact Trash Count | GET | /Contact/TrashCount |
conn_mod_def::GJ0HlQkTdc4::55008tGFTQy_Xj0Td5Ndyg |
| Get Contacts Count (by List IDs and Segment IDs) | GET | /Contact/Count/{{listIDs}}/{{segmentIDs}} |
conn_mod_def::GJ0HjQ1X79M::fkXj6K_UTneqRnDp67TT5A |
| Get Filtered Contacts in a List | GET | /Contact/{{listId}}/ContactDetails |
conn_mod_def::GJ0Hj4SREWY::6KdAEv2yRGuTu54Q5YSBDA |
| Get Filtered Contacts with Extra Fields (for a List) | GET | /Contact/{{listId}}/ContactDetails/ExtraFields |
conn_mod_def::GJ0HkC_w0ok::1K1hkawuSUq0i8826bioMA |
| Get Unique Contact Count | GET | /Contact/UniqueCount |
conn_mod_def::GJ0HlaMB7tM::fxGqARSgSwipHvFzKcV4IQ |
| List Contacts | GET | /Contact/ |
conn_mod_def::GJ0HhOr9Ew0::NHXdkw7JQUezv6AjTSa4DA |
19 more Contacts actions are available through search.
Integration
| Action | Method | Path | Action id |
|---|---|---|---|
| Get Shopify Product Grid (Tabular HTML) | GET | /Integration/ShopifyProductGrid |
conn_mod_def::GJ0H3VDloDM::mFBD8DeaRk6dRssT_gc_BA |
| LinkedIn Test Connection | GET | /Integration/LinkedInTest |
conn_mod_def::GJ0H4WKPUIk::pOiti90PQOKuWdrRdJOB2g |
| SalesForce Test (Integration) | GET | /Integration/SalesForceTest |
conn_mod_def::GJ0H4v1sZ6g::XpJE3NpgT1aS4ZjxslhjpQ |
| Test eBay Integration | GET | /Integration/EbayTest |
conn_mod_def::GJ0H5E0acUg::HrnXWAGRRHSCFarWIyXHLw |
| Test Etsy Integration | GET | /Integration/EtsyTest |
conn_mod_def::GJ0H5MBpAso::16vzvPrAS-mpIIJsF1o5xA |
| Test EventBrite Integration | GET | /Integration/EventbriteTest |
conn_mod_def::GJ0H5TgIY-w::DhFeZn9RRh-FnKWJw_vkfg |
| Test Facebook Events Integration | GET | /Integration/FacebookEventsTest |
conn_mod_def::GJ0H5cNveDc::-s8m6DDPQw24JTRz-6GvUw |
| Test Instagram Connection | GET | /Integration/InstagramTest |
conn_mod_def::GJ0H5roBUFs::X9S8cgMJRo2nlLdO7o_Rhg |
| Test Pinterest Integration | GET | /Integration/PinterestTest |
conn_mod_def::GJ0H5y-xl3A::z-g4g7ooQ0m_w1NM312FWg |
| Test Twitter Integration | GET | /Integration/TwitterTest |
conn_mod_def::GJ0H56AX6z8::aVNVcFo2Tcu9DwvsUAa8Ow |
| Twitter Tweet Test | GET | /Integration/TwitterTweetsTest |
conn_mod_def::GJ0H6BLgasU::6bAgrNHDTdehhS5W-cSc-A |
| Connect to a Service (Get Auth URL with Extra Data) | POST | /Integration/AuthUrlExtra/{{authSite}} |
conn_mod_def::GJ0Hzy71Rhs::WAiqBtPPSJKWALzjY5QvFQ |
4 more Integration actions are available through search.
ContactLists
| Action | Method | Path | Action id |
|---|---|---|---|
| Get a Contact List’s Details | GET | /Contact/{{listId}} |
conn_mod_def::GJ0Hi_JIzH8::HpW4BRtcTd294BR5CN-dkA |
| Get Contact Lists by List IDs | GET | /Contact/{{listIDs}}/All |
conn_mod_def::GJ0Hik_LodU::LoBMa-dKQsyO55sAiwblcw |
| Create a Contact List | POST | /Contact/ |
conn_mod_def::GJ0HezrjgJI::GWnn2riAT-6DF-LRU9poXQ |
| Delete a Contact List | DELETE | /Contact/{{listId}} |
conn_mod_def::GJ0HfUFWZVg::hGOIBLRGRQKjM-qxEC76xw |
| Delete a Contact List from Trash | DELETE | /Contact/{{listId}}/Trash |
conn_mod_def::GJ0HgyAeXfY::n4GKmizNSe28MlPpxt0KTw |
| Delete Lists | DELETE | /Contact/DeleteList/{{listIDs}} |
conn_mod_def::GJ0HfbsoLhE::1tUQFnPXRea8yvhQbw0WaA |
| Delete Trash List | DELETE | /Contact/DeleteTrashList/{{listIDs}} |
conn_mod_def::GJ0Hg5cq0U8::zr6AfwiaSYCWFhDseOLlug |
| Modify a Contact List | PATCH | /Contact/{{listId}} |
conn_mod_def::GJ0HmCcnU4Y::mksusTG4She7fZdH_L5PRA |
| Restore Trash List(s) | PATCH | /Contact/RestoreTrashList/{{listIDs}} |
conn_mod_def::GJ0HmnuWG3E::jjD_3h3mTMqFjsDCTgmG-Q |
| Share a Contact List with Sub-Accounts | POST | /Contact/{{listId}}/ShareLists/{{clientIds}} |
conn_mod_def::GJ0HnagV_P8::Gk0ZzZTSTtqN4E1-dcZF1A |
SignupForms
| Action | Method | Path | Action id |
|---|---|---|---|
| Get a Signup Form Link | GET | /SignupForm/{{id}}/Link |
conn_mod_def::GJ0H9637aGI::ltrO51G1SzuaKKRh1IqVXw |
| Get a Signup Form’s Button Code | GET | /SignupForm/{{id}}/Code/Button |
conn_mod_def::GJ0H9qz7V7w::yiMDZrqpR9mQiKWAi2DuwQ |
| Get a Signup Form's Details | GET | /SignupForm/{{id}} |
conn_mod_def::GJ0H8t1uvao::ljAf16qwRfqgYHn8CglGKg |
| Get a Signup Form’s Preview Code | GET | /SignupForm/{{id}}/Code/Preview |
conn_mod_def::GJ0H9c0IDW0::ZcabpV8RRw-qC0uGM21xhA |
| Get Signup Form List | GET | /Contact/ListbuilderList |
conn_mod_def::GJ0Hk11exIc::0TXlzWIDQR6FK6_bz1yx6g |
| List Signup Forms | GET | /SignupForm |
conn_mod_def::GJ0H-JJTZ-g::eoVVzmV5SbSb7caQGN8eNA |
| Copy an Existing Signup Form | POST | /SignupForm/{{id}}/Copy |
conn_mod_def::GJ0H8WDwJG0::d5QeMvhHRYavX4MXxSFVNQ |
| Create a Signup Form | POST | /SignupForm/ |
conn_mod_def::GJ0H8dTX3uo::BzRNKjtETHSc36uWwEIudQ |
| Delete an Existing Signup Form | DELETE | /SignupForm/{{id}} |
conn_mod_def::GJ0H8k4Mbjg::HI7N7VK3RwyLkJ9qTme_DQ |
| Update a Signup Form | PATCH | /SignupForm/{{id}} |
conn_mod_def::GJ0H-afRcvk::em7CpkGKTJ-OmRjfEK90Vg |
Images
| Action | Method | Path | Action id |
|---|---|---|---|
| Get Account Image Hosting Summary | GET | /Images/Summary |
conn_mod_def::GJ0HyPaGusc::FmdW_ELfSNemmnyORk0JGw |
| Get Image Details | GET | /Images/{{imageId}} |
conn_mod_def::GJ0HyWAX-oo::3WBIXYMLSYaakj-hDXOV0A |
| List Images | GET | /Images/ |
conn_mod_def::GJ0Hx_k7Qes::IN_n9m3CRtGYjstac5-PoQ |
| Copy an Image to a Sub-account | POST | /Images/{{imageId}}/Copy |
conn_mod_def::GJ0HxsyQmRE::Bu3hUYwUQ0WvJP2W_xoOBQ |
| Delete an Image | DELETE | /Images/{{imageId}} |
conn_mod_def::GJ0HxzbtG8c::WL9gi-VnSMuXpap3noKXrg |
| Update an Image | PATCH | /Images/{{imageId}} |
conn_mod_def::GJ0HynugRFI::R9VZtrCnRSWwqI95O0k6DQ |
| Upload an Image | POST | /Images/ |
conn_mod_def::GJ0Hyw7YQEo::l2nP_O_oTlSyIPb-2Mj30Q |
| Upload Logo Image (by Image Type and Extra) | POST | /Images/{{imageType}}/{{extra}} |
conn_mod_def::GJ0Hy4qPOso::ZXY2UTEoS_yrIyUQAEmUqg |
AbSplit
| Action | Method | Path | Action id |
|---|---|---|---|
| Get an A/B Split Test Compare Report | GET | /ABSplit/{{id}}/Compare |
conn_mod_def::GJ0HY2V1mfU::Sbjy7P_bT56G7cIErHbSdQ |
| Get an AB Split Test’s Details | GET | /ABSplit/{{id}} |
conn_mod_def::GJ0HY9O125Y::QulcQCK9S4G1f3JG1iF9Hw |
| Get an AB Split Test’s Results | GET | /ABSplit/{{id}}/Results |
conn_mod_def::GJ0HZQGj-Lw::_LgM3rYaQhqCwTm9sLM_Sg |
| List AB Tests | GET | /ABSplit/ |
conn_mod_def::GJ0HYrgffWw::dU3-8PV-SsCgYi2YHCvwEw |
| Delete an AB Test Email | DELETE | /ABSplit/{{id}} |
conn_mod_def::GJ0HYSnatUE::1_-30ts2RAGFGelKNXX56A |
| Update an AB Test (AB Split) | PATCH | /ABSplit/{{id}} |
conn_mod_def::GJ0HZZrnpBw::MfLWMZY4SHaDMvv0HsGEdw |
| Update an AB Test’s Status | PATCH | /ABSplit/{{id}}/Status |
conn_mod_def::GJ0HZjGykP8::5nByi6ZmQTSwqNMVkr-dsA |
ContactSegments
| Action | Method | Path | Action id |
|---|---|---|---|
| Get a Contact Segment by ID | GET | /Contact/Segments/{{segmentId}} |
conn_mod_def::GJ0HkVPu_iA::HmSOgDwtSvWP9YuCrXa3pQ |
| Get a List’s Auto-Generated Segment Name | GET | /Contact/Segments/Name/{{listId}} |
conn_mod_def::GJ0HkNcqGBs::XvGIWNSwRMSIRNJrDquWkg |
| Get Download Data for a Contact Segment | GET | /Contact/{{id}}/Segment/Download |
conn_mod_def::GJ0HjkDaQuQ::w42yH4TeQWiSrcP_ozzhmg |
| List Contact Segments | GET | /Contact/Segments |
conn_mod_def::GJ0HlrYPcSc::YL5r-xMDQkauyKqPyijT3A |
| Delete a Contact Segment | DELETE | /Contact/Segments/{{segmentId}} |
conn_mod_def::GJ0HfqOQobM::WLdurE1ESb2J9tpkaQYNKw |
| Update a Contact Segment | PATCH | /Contact/Segments/{{segmentId}} |
conn_mod_def::GJ0Hn0RX14o::p3-CPKS_T0ie2Rxah4G8RA |
Polls
| Action | Method | Path | Action id |
|---|---|---|---|
| Get a Poll Preview (Render) | GET | /Poll/{{pollId}}/Render |
conn_mod_def::GJ0H8G1Atdo::NNKHankiQ8-opd61MzLwMw |
| List Polls | GET | /Poll/ |
conn_mod_def::GJ0H72aHXlY::Io6z3pq_TFuB1NQd9gYNfg |
| Copy a Poll | POST | /Poll/{{pollId}}/Copy |
conn_mod_def::GJ0H7QLnLDc::ebVjlS2qQDScqxK_LWWRmw |
| Create Poll | POST | /Poll/ |
conn_mod_def::GJ0H7YNBros::3jwAhuj7RYuO78TyKtP-dQ |
| Delete a Poll | DELETE | /Poll/{{pollId}} |
conn_mod_def::GJ0H7kegYOY::rdOZ2XTbTEK8JBk6SkCk3A |
| Update a Poll | PATCH | /Poll/{{pollId}} |
conn_mod_def::GJ0H8OS7sJs::aDprqRbYTdywyNOJJk4zKQ |
Client
| Action | Method | Path | Action id |
|---|---|---|---|
| Check if Responsive | GET | /Client/Responsive |
conn_mod_def::GJ0IB6aNSrU::KMNruKf0TwiPifMeEL9KJQ |
| Get Client Details | GET | /Client/ |
conn_mod_def::GJ0IC5LE8Pw::Go6ayc_4SVyRL-N6CMGRIA |
| Change Client Password | PATCH | /Client/Password |
conn_mod_def::GJ0IBeYKlRo::ujTG-DCPRRW_rIWyoy3Siw |
| Link a Client Account | POST | /Client/LinkAccount/ |
conn_mod_def::GJ0IFb_-uow::nVFNtlfyQ-KjiwM4kljnxA |
| Set Responsive (Client) | PATCH | /Client/Responsive |
conn_mod_def::GJ0IGOHAi7Y::RtQyw-Z3SRGtc1ZjRrCYDg |
| Update/Edit Client Profile | PATCH | /Client/ |
conn_mod_def::GJ0IGrFixtE::FGg6lYOlTG6Pj5HUly0plg |
SubAccounts
| Action | Method | Path | Action id |
|---|---|---|---|
| Get a Sub-Account’s Balance | GET | /Client/SubAccount/{{id}}/Balance |
conn_mod_def::GJ0IEeX3gaM::gdZgNo_aTPunfuVRqiNR4g |
5 more SubAccounts actions are available through search.
This lists 90 of 348 actions. For anything not here, call search_one_platform_actions with platform benchmark-email. The full catalog is at https://www.withone.ai/knowledge/benchmark-email.
When a call fails
The error comes from Benchmark Email, 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/benchmark-email
Integration knowledge by One (withone.ai), licensed under One-Knowledge-1.0. Attribution must be preserved in derivative works.