withoneai Simplero through One
Simplero is an all-in-one business platform for coaches, course creators, and thought leaders that combines courses, community, email, CRM, payments, and automations, allowing users to run sales, customer communication, and digital programs from a single system.
One exposes Simplero 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 platformsimpleroif 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 Simplero 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 Simplero 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
Customers
| Action | Method | Path | Action id |
|---|---|---|---|
| Get a Contact | GET | /api/v2/customers/{{id}} |
conn_mod_def::GMPzbdwcHFg::cu4Ltde2QEa0kYjuLx-0Fw |
| List Customers | GET | /api/v2/customers |
conn_mod_def::GMPzcBaQA8A::l3N6fgutS46I-IYnDF9Yew |
| Add Badge for a Customer | POST | /api/v2/customers/{{id}}/actions/add_badge |
conn_mod_def::GMPza32WPmg::t_U8YH3gT9aHP2f8ulKtBQ |
| Add Paid Purchase to a Customer's Product | POST | /api/v2/customers/{{id}}/actions/product_add_paid_purchase |
conn_mod_def::GMPza4KpWLg::QjTnBnz9SRGtYhD_PKEDdw |
| Add Tag to a Customer | POST | /api/v2/customers/{{id}}/actions/add_tag |
conn_mod_def::GMPza5YyvDA::eqCM7qtKR9WEQLqBJZoH2w |
| Add to Affiliate Program for a Customer | POST | /api/v2/customers/{{id}}/actions/add_to_affiliate_program |
conn_mod_def::GMPza4iLMNA::cRm-u2SZTjSBVH4ai5WRag |
| Add to Coaching Program for a Customer | POST | /api/v2/customers/{{id}}/actions/coaching_client_add |
conn_mod_def::GMPzbBFHO_g::IE-CmhM-TSmMlBlpRUvmsQ |
| Add to Conversation for a Customer | POST | /api/v2/customers/{{id}}/actions/add_to_conversation |
conn_mod_def::GMPza_oAijA::xYwtwxDTTQCn4p11InnUFg |
| Add to Meta Custom Audience for a Customer | POST | /api/v2/customers/{{id}}/actions/add_to_meta_custom_audience |
conn_mod_def::GMPzbA7PSqA::rnNlM5wCQ_2MggeZ5RUGuw |
| Adjust Lead Score for a Customer | POST | /api/v2/customers/{{id}}/actions/adjust_lead_score |
conn_mod_def::GMPzbA7X3fA::q0vQPPuwQqqrnxARTOyS8w |
| Approve Registration for an Event for a Customer | POST | /api/v2/customers/{{id}}/actions/approve_registration_for_an_event |
conn_mod_def::GMPzbBLBj4g::MEfyAifySpyvlDE-KoPqwQ |
| Archive a Contact | POST | /api/v2/customers/{{id}}/actions/mark_as_archived |
conn_mod_def::GMPzbH0PWgA::G-rWdMIHT9WVNavFpp62Yw |
99 more Customers actions are available through search.
Pages
| Action | Method | Path | Action id |
|---|---|---|---|
| Get a Page | GET | /api/v2/pages/{{id}} |
conn_mod_def::GMPzjwlAOIg::k2-y4u3HQlCxL2Ah4KRdaw |
| Get Builder Node Type Schema for a Page | GET | /api/v2/pages/{{id}}/builder/content/node_types/detail |
conn_mod_def::GMPzj0A3QCA::EvV4LRzuSHubty1nw875yQ |
| Get Builder Node Type Settings Detail for a Page | GET | /api/v2/pages/{{id}}/builder/content/node_types/settings_detail |
conn_mod_def::GMPzj95ld6g::mw-V8md4TS6qC9CUyFHw-A |
| Get HTML Section Content for a Page | GET | /api/v2/pages/{{id}}/builder/content/html_section |
conn_mod_def::GMPzj-MoTxg::DDCox9wERD-YG5TcvcYPxA |
| List Available Builder Node Types for a Page | GET | /api/v2/pages/{{id}}/builder/content/node_types |
conn_mod_def::GMPzkF7XKoA::U-iSHPBLQTehQzqVMr1ipw |
| List Pages | GET | /api/v2/pages |
conn_mod_def::GMPzkINGxbA::ISGMfSbcSUK47Y7X3f3PHA |
| Add Labels to a Page | POST | /api/v2/pages/{{id}}/actions/add_labels |
conn_mod_def::GMPzjbvYG-g::J9uipRKUT36xWQ0nIDPnAA |
| Add to Main Nav for a Page | POST | /api/v2/pages/{{id}}/actions/add_to_main_nav |
conn_mod_def::GMPzjaiLisA::M6xID_MAT6myjmipBUq0zQ |
| Clone a Page to Another Site | POST | /api/v2/pages/{{id}}/actions/clone_to_site |
conn_mod_def::GMPzjZ7j5JA::uA5mL7WRScaOHlTq4dtBaA |
| Convert a Page to a Landing Page | POST | /api/v2/pages/{{id}}/actions/convert_to_landing_page |
conn_mod_def::GMPzkugZFMg::6iXLz8qtSmmA1P8JydZb-w |
| Convert to Builder V2 for a Page | POST | /api/v2/pages/{{id}}/actions/convert_to_builder_v2 |
conn_mod_def::GMPzjZvAMng::jrCJp8SRSD6lQOKViWbH4Q |
| Create a Builder Doc Node for a Page | POST | /api/v2/pages/{{id}}/builder/content/nodes |
conn_mod_def::GMPzjjqMDXg::PyVBeQRzTleV1MvR_-KZ5A |
32 more Pages actions are available through search.
Courses
| Action | Method | Path | Action id |
|---|---|---|---|
| Get a Course | GET | /api/v2/courses/{{id}} |
conn_mod_def::GMPzZ39FUpg::b6QeKLlIQ_26dCweBwebAA |
| List Courses | GET | /api/v2/courses |
conn_mod_def::GMPzaCJ2f6A::cU9Pz6SSR8Sivx4GRgUK5A |
| Add Labels to a Course Action | POST | /api/v2/courses/{{id}}/actions/add_labels |
conn_mod_def::GMPzZnK9Vag::hyXYOBkrS7Kq_uSyA65Z-Q |
| Allow Downloads for a Course | POST | /api/v2/courses/{{id}}/actions/allow_downloads |
conn_mod_def::GMPzZobVtpg::RNM1NXeDRXCRnjCYuc2C1w |
| Create a Course | POST | /api/v2/courses |
conn_mod_def::GMPzZxk0kag::HZlp3D62QVeORf4RW0UJAw |
| Delete Ai Generated Summaries Using Courses Actions | POST | /api/v2/courses/{{id}}/actions/delete_ai_generated_summaries |
conn_mod_def::GMPzZw4TnaA::PrC8p2gSQvqMWIueHERP_Q |
| Disable Autoplay for a Course | POST | /api/v2/courses/{{id}}/actions/disable_autoplay |
conn_mod_def::GMPzZwpfOJA::368-SOI2Sr-m7JNZCtotNw |
| Drip a Course | POST | /api/v2/courses/{{id}}/actions/drip |
conn_mod_def::GMPzZwQkINA::CXC6TeuORImWz9HcJva0pA |
| Duplicate a Course | POST | /api/v2/courses/{{id}}/actions/duplicate |
conn_mod_def::GMPzZwQZYtA::rOO3QXTLS0aUAUsgdQNSkQ |
| Duplicate to Other Site for a Course | POST | /api/v2/courses/{{id}}/actions/duplicate_to_other_site |
conn_mod_def::GMPzZ5DEHOg::-858P4dGS4Spl6iJcL4Saw |
| Enable Autoplay for a Course | POST | /api/v2/courses/{{id}}/actions/enable_autoplay |
conn_mod_def::GMPzZ4Yjq1A::t7RwYGJXRkqpYaZpS6Dahw |
| Exclude From New Content for a Course | POST | /api/v2/courses/{{id}}/actions/exclude_from_new_content |
conn_mod_def::GMPzZ4HkPIA::7cmeJ51bQ2GA2sF7oJaD8A |
20 more Courses actions are available through search.
CourseLessons
| Action | Method | Path | Action id |
|---|---|---|---|
| Get a Course Lesson by ID | GET | /api/v2/course_lessons/{{id}} |
conn_mod_def::GMPzZFu2TxA::EbkaHMK-TkGylvWp7UInBw |
| List Course Lessons | GET | /api/v2/course_lessons |
conn_mod_def::GMPzZHscxrg::AUDldKgFRpuRYDO_fLqQ9w |
| Allow Multiple Completions for a Course Lesson | POST | /api/v2/course_lessons/{{id}}/actions/allow_multiple_completions |
conn_mod_def::GMPzY3HaRFA::aM517ND5SvyEacvSwiXQyw |
| Apply Loudness Filter to a Course Lesson | POST | /api/v2/course_lessons/{{id}}/actions/apply_loudness_filter |
conn_mod_def::GMPzY28Pg8A::YhPVi1BMQ2CI7LLAV_yCLg |
| Create a Course Lesson | POST | /api/v2/course_lessons |
conn_mod_def::GMPzY-JAAnA::Gi72QSf_S86NSb4foEwnfQ |
| Deepgram Using Course Lessons | POST | /api/v2/course_lessons/{{id}}/actions/deepgram |
conn_mod_def::GMPzZWwwlNA::6q6z2O9CSx6ji6-VvYPmiA |
| Delete AI Generated Summary for a Course Lesson | POST | /api/v2/course_lessons/{{id}}/actions/delete_ai_generated_summary |
conn_mod_def::GMPzY-BSPDA::TM9bwRrlSCmRy_V5Ygs5Ww |
| Disable Preferred Playback Rate for a Course Lesson | POST | /api/v2/course_lessons/{{id}}/actions/disable_preferred_playback_rate |
conn_mod_def::GMPzZW77l8g::R7P45F0PSA2iYylw0FKHiQ |
| Disallow Multiple Completions for a Course Lesson | POST | /api/v2/course_lessons/{{id}}/actions/disallow_multiple_completions |
conn_mod_def::GMPzZFWY6OA::zAdz-mozSD6HhGCKJ2p0CQ |
| Duplicate a Course Lesson | POST | /api/v2/course_lessons/{{id}}/actions/duplicate |
conn_mod_def::GMPzZE9PeUA::W2sNnWxSTZCcSdWVkqFQMg |
| Enable Preferred Playback Rate for a Course Lesson | POST | /api/v2/course_lessons/{{id}}/actions/enable_preferred_playback_rate |
conn_mod_def::GMPzZXPwg4g::ms50Bt0qS8qHTu3gksaMRg |
| Move to Module for a Course Lesson | POST | /api/v2/course_lessons/{{id}}/actions/move_module |
conn_mod_def::GMPzZF1w1Dg::82V4DJDuRhmL6XifzeVVeA |
13 more CourseLessons actions are available through search.
LandingPages
| Action | Method | Path | Action id |
|---|---|---|---|
| Get a Landing Page | GET | /api/v2/landing_pages/{{id}} |
conn_mod_def::GMPzhtU-kRg::py3YaxOlTfCbr7U86NP9bA |
| Get Builder Node Type Schema for a Landing Page | GET | /api/v2/landing_pages/{{id}}/builder/content/node_types/detail |
conn_mod_def::GMPzhuzFo1g::HAAsPMN5Qf-IWJ884pMH6g |
| Get HTML Section Content for a Landing Page | GET | /api/v2/landing_pages/{{id}}/builder/content/html_section |
conn_mod_def::GMPzh3gBHdA::CLSpukioRjuMbta5GJMnmw |
| Get the Builder Doc Node Tree for a Landing Page | GET | /api/v2/landing_pages/{{id}}/builder/content/nodes |
conn_mod_def::GMPzh3VueIg::AYRlAbRPS4qbn9Ov34PIkw |
| List Landing Pages | GET | /api/v2/landing_pages |
conn_mod_def::GMPzh7MRelA::K_lyz2kPTZOHQqQMH0jCFg |
| Add Labels for a Landing Page | POST | /api/v2/landing_pages/{{id}}/actions/add_labels |
conn_mod_def::GMPzhc8BduA::0U0ZbRQOTN6qnFS7Sqh3GA |
| Convert to Builder v2 for a Landing Page | POST | /api/v2/landing_pages/{{id}}/actions/convert_to_builder_v2 |
conn_mod_def::GMPzhdy-1DA::bkah2Gi9QvCxsde0jsXBLw |
| Create a Funnel from a Landing Page | POST | /api/v2/landing_pages/{{id}}/actions/create_funnel_from |
conn_mod_def::GMPziLvQzrA::n2_RFFuDTeGR6LPsvHiCzw |
| Create a Landing Page | POST | /api/v2/landing_pages |
conn_mod_def::GMPzhlAm9RA::dzIeugvlRQaNJM9kBTiONg |
| Create or Update HTML Section Content for a Landing Page | POST | /api/v2/landing_pages/{{id}}/builder/content/html_section |
conn_mod_def::GMPzhkik-bg::AnjtbMJkSSa8gXZ0NERDpQ |
| Duplicate a Landing Page | POST | /api/v2/landing_pages/{{id}}/actions/duplicate |
conn_mod_def::GMPzhk2kGsA::fBWqNCOjQ6Kgp79KcxWHCw |
| Move to Funnel for a Landing Page | POST | /api/v2/landing_pages/{{id}}/actions/move_to_funnel |
conn_mod_def::GMPzh3vQcWg::kanZ-ajzSia9DeaRGPS7gA |
12 more LandingPages actions are available through search.
Tickets
| Action | Method | Path | Action id |
|---|---|---|---|
| Get a Ticket | GET | /api/v2/tickets/{{id}} |
conn_mod_def::GMPzqArgF9A::qvQOEpaRTXKExr7XkeB9cg |
| List Tickets | GET | /api/v2/tickets |
conn_mod_def::GMPzqGCvrvA::9wNwHU5BSUy7N_au_lABVQ |
| Add Comment to a Ticket | POST | /api/v2/tickets/{{id}}/actions/add_comment |
conn_mod_def::GMPzp4Z-Rtg::wChqkSBsT0igJ1Lclljf6w |
| Add Facet to a Ticket | POST | /api/v2/tickets/{{id}}/actions/add_facet |
conn_mod_def::GMPzp6QCqHA::b3ll5Z2_RbarO3aXJhqwpA |
| Add Facet Values to a Ticket | POST | /api/v2/tickets/{{id}}/actions/add_facet_values |
conn_mod_def::GMPzp4gnnZA::S2gF1z4NT-aHOPNEgo1yXA |
| Assign to Me for a Ticket | POST | /api/v2/tickets/{{id}}/actions/assign_to_me |
conn_mod_def::GMPzqBwF8Jg::xzt8KoBqS5awdD_u7bP8vw |
| Create a Ticket | POST | /api/v2/tickets |
conn_mod_def::GMPzqArVB8g::17fjZ2OfSI6WJ4DORjEBxw |
| Exclude From CSAT Reporting for a Ticket | POST | /api/v2/tickets/{{id}}/actions/exclude_from_csat |
conn_mod_def::GMPzqBD8XPA::JlmjVJ-ZQfW86hjKkxsy0w |
| Mark Read by Assignee for a Ticket | POST | /api/v2/tickets/{{id}}/actions/mark_read |
conn_mod_def::GMPzqMs8tOg::qSQaJpUEQtmmGrXC_5xUgQ |
| Mark Unread by Assignee for a Ticket | POST | /api/v2/tickets/{{id}}/actions/mark_unread |
conn_mod_def::GMPzqNzsUzg::O-kAZdpEQXqtyFty1zeBjg |
| Move to Pipeline for a Ticket | POST | /api/v2/tickets/{{id}}/actions/move_to_pipeline |
conn_mod_def::GMPzqNule1g::tGwN-FKnQc-oO9lyqn8A_A |
| Move to Stage for a Ticket | POST | /api/v2/tickets/{{id}}/actions/move_to_stage |
conn_mod_def::GMPzqNTaEkg::Zk_SlPCeRL-Z1ji4PdUzmg |
6 more Tickets actions are available through search.
Purchases
| Action | Method | Path | Action id |
|---|---|---|---|
| Get a Purchase | GET | /api/v2/purchases/{{id}} |
conn_mod_def::GMPzmPRmXIA::UK2QPQJqTZ2j7dDQpu6Y0Q |
| List Purchases | GET | /api/v2/purchases |
conn_mod_def::GMPzmXAznSg::gaJ0Fv2TS2Wp2rNKo6WgUQ |
| Cancel a Purchase | POST | /api/v2/purchases/{{id}}/actions/cancel |
conn_mod_def::GMPzmIL2I6A::WR1E8XwyQ-6yIQmAHxWWxg |
| Capture a Purchase | POST | /api/v2/purchases/{{id}}/actions/capture |
conn_mod_def::GMPzmINTrPA::qLlwvugUS8-TwzMPXi__YQ |
| Change Price for a Purchase | POST | /api/v2/purchases/{{id}}/actions/change_price |
conn_mod_def::GMPzmHdnGAA::SVUUe1UVSGiMvWw2JVpAKQ |
| Change Tax Percent for a Purchase | POST | /api/v2/purchases/{{id}}/actions/change_tax_percent |
conn_mod_def::GMPzmPqNdxA::AbJIzV1DQIa8x8TQ9EwObw |
| Disassociate a Purchase From a Funnel | POST | /api/v2/purchases/{{id}}/actions/disassociate_from_funnel |
conn_mod_def::GMPzmPRi2hA::BS3SV6QdSMSTduY2NJHjfg |
| Move to Product for a Purchase | POST | /api/v2/purchases/{{id}}/actions/move_to_product |
conn_mod_def::GMPzmPRGi_g::h5Flt1AgTtWvGhRLrdqwyQ |
| Pause a Purchase | POST | /api/v2/purchases/{{id}}/actions/pause |
conn_mod_def::GMPzmds5fKA::BEH7yOpQTbW2RujkRFQO6w |
| Postpone Period Ends At By for a Purchase | POST | /api/v2/purchases/{{id}}/actions/postpone_period_ends_at_by |
conn_mod_def::GMPzmeO49oA::HA8te-C1ROWSUhvfBsDDRw |
| Postpone Upcoming Charges By for a Purchase | POST | /api/v2/purchases/{{id}}/actions/postpone_upcoming_charges_by |
conn_mod_def::GMPzmeUzu1g::ZhIolZxJSAixyyOODnPN8A |
| Refund a Purchase | POST | /api/v2/purchases/{{id}}/actions/refund |
conn_mod_def::GMPzmdtjxNg::llCZ1dp_QsWrvtl96PUVRw |
4 more Purchases actions are available through search.
Affiliates
| Action | Method | Path | Action id |
|---|---|---|---|
| Get an Affiliate | GET | /api/v2/affiliates/{{id}} |
conn_mod_def::GMPzWRBWgYA::lYOMbTx_Qh6JunrnTnJ9cg |
| List Affiliates | GET | /api/v2/affiliates |
conn_mod_def::GMPzWUFpxNA::n3clGLINTLyrLISKvn7vZQ |
| Add to Conversation for an Affiliate | POST | /api/v2/affiliates/{{id}}/actions/add_to_conversation |
conn_mod_def::GMPzWJoJJrg::vBvhk01hSNynGTFvgcqm9A |
| Approve an Affiliate | POST | /api/v2/affiliates/{{id}}/actions/approve |
conn_mod_def::GMPzWJctWuA::XH5g-_DbRZWAmXyOPHKtQw |
| Approve Documentation for an Affiliate | POST | /api/v2/affiliates/{{id}}/actions/approve_documentation |
conn_mod_def::GMPzWJnY9sg::ygvSxMBRTNarBCYfQeGHPg |
| Create an Affiliate | POST | /api/v2/affiliates |
conn_mod_def::GMPzWRBclDA::OEkBUUDSR5-qH6oDzh9mwA |
9 more Affiliates actions are available through search.
This lists 90 of 719 actions. For anything not here, call search_one_platform_actions with platform simplero. The full catalog is at https://www.withone.ai/knowledge/simplero.
When a call fails
The error comes from Simplero, 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/simplero
Integration knowledge by One (withone.ai), licensed under One-Knowledge-1.0. Attribution must be preserved in derivative works.