SupportBee through One
SupportBee is a customer support platform that provides a shared inbox, ticket management, knowledge base tools, and collaboration features, allowing support teams to manage customer conversations, organize requests, and respond efficiently through email-based workflows and integrations.
One exposes SupportBee 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 support-bee 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 SupportBee 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 SupportBee 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
Tickets
| Action |
Method |
Path |
Action id |
| Fetch Audit Trail for a Ticket |
GET |
/tickets/{{id}}/audit |
conn_mod_def::GL-vs0rVIPE::CPqUIHrcSqm6lGBN96GksA |
| Fetch Draft for a Ticket |
GET |
/tickets/{{id}}/draft |
conn_mod_def::GL-vs1AUmNY::8wOob4beT-etXhLLayYVqg |
| List Tickets |
GET |
/tickets |
conn_mod_def::GL-vs4Fow0w::W0kTRyetR6q7IAOTYDBLUw |
| Retrieve a Ticket |
GET |
/tickets/{{id}} |
conn_mod_def::GL-vtAD9gKU::dfMcGy6_SlehpQvjgVloiw |
| Search Tickets |
GET |
/tickets/search |
conn_mod_def::GL-vtIwu1Mk::UI8J9O2ZSAGIHijWPsGMpA |
| Add Label to a Ticket |
POST |
/tickets/{{ticketId}}/labels/{{labelName}} |
conn_mod_def::GL-vsW_bsWM::C0wdAsfRQQqj8IYifdqnNw |
| Archive a Ticket |
POST |
/tickets/{{id}}/archive |
conn_mod_def::GL-vsVHpuK8::JW1o-gLQSCuMX-WABddh9Q |
| Assign a Ticket to a User |
POST |
/tickets/{{id}}/user_assignment |
conn_mod_def::GL-vsmPpZWc::GDpPuP76QBiEWMooTnqdPg |
| Create Draft for a Ticket |
POST |
/tickets/{{id}}/draft |
conn_mod_def::GL-vstiUPQI::G2S_hUAITKy8ghICzK8u7Q |
| Create Ticket |
POST |
/tickets |
conn_mod_def::GL-vsuFs0bI::u7sMajjZQ4yUlgmuPnin5Q |
| Delete a Trashed Ticket |
DELETE |
/tickets/{{id}} |
conn_mod_def::GL-vstf0rYU::BMjEMwjpQraTPf_jb_FsHQ |
| Delete Draft for a Ticket |
DELETE |
/tickets/{{id}}/draft |
conn_mod_def::GL-vsuC7Urw::KZQQ8WPUQj-SYcvz_Qf0Vw |
11 more Tickets actions are available through search.
Users
| Action |
Method |
Path |
Action id |
| Fetch Users and Customer Groups |
GET |
/users |
conn_mod_def::GL-vtY-HnUw::0HmOLNJzTFmmdxl_X8jIwg |
| Show User or Customer Group |
GET |
/users/{{id}} |
conn_mod_def::GL-vtXvij_w::Evqj4CTtSK2JMZkfvCP1vQ |
| Add Member to a User's Members |
POST |
/users/{{id}}/members |
conn_mod_def::GL-vtQFR5Lw::N32w1V5XRumoPd4CYCUy4g |
| Create a User or Customer Group |
POST |
/users |
conn_mod_def::GL-vtXuI2Jg::Bew-w3eXTze2Om_mMYsjhQ |
| Update a User |
PUT |
/users/{{id}} |
conn_mod_def::GL-vtX4oJCM::Yn1gTtbvScibNFfVJBzStQ |
Snippets
| Action |
Method |
Path |
Action id |
| Fetch Snippets |
GET |
/snippets |
conn_mod_def::GL-vr-6KGzc::D8UEcA2qRR-PIq3K1ufYEA |
| Create Snippet |
POST |
/snippets |
conn_mod_def::GL-vsAS6z6g::0i2wEJlMTpujP404YF8hvw |
| Delete Snippet |
DELETE |
/snippets/{{id}} |
conn_mod_def::GL-vsBm2Jwc::oi9RFZxgTTuocFchJIEgbg |
| Update a Snippet |
PUT |
/snippets/{{id}} |
conn_mod_def::GL-vr_HUcAU::3t7g_NZ2Rty_p9DcVld14A |
Emails
| Action |
Method |
Path |
Action id |
| Fetch Emails |
GET |
/emails |
conn_mod_def::GL-vrs8CMFM::UOid97o_SbKO3jvkQdm1cQ |
| Create Email |
POST |
/emails |
conn_mod_def::GL-vrs3O96I::mtsaXwFfQfOexdwgqGo_hQ |
Reports
| Action |
Method |
Path |
Action id |
| Average First Response Time Report |
GET |
/reports/avg_first_response_time |
conn_mod_def::GL-vr2-U5vM::w2ASjlpNRWuGXvpfcZR4Xg |
| Replies Count Report |
GET |
/reports/replies_count |
conn_mod_def::GL-vr5SruYc::VF71ErLwQSSjAOqNclclGQ |
Comments
| Action |
Method |
Path |
Action id |
| Fetch Comments for a Ticket |
GET |
/tickets/{{id}}/comments |
conn_mod_def::GL-vs1QIBpU::I0qOBy9GQviC865LG477FQ |
| Create a Comment on a Ticket |
POST |
/tickets/{{id}}/comments |
conn_mod_def::GL-vsuBxhrg::Zooyko3cR6eA0kxuj__LsQ |
TicketReplies
| Action |
Method |
Path |
Action id |
| Fetch Ticket Replies |
GET |
/tickets/{{id}}/replies |
conn_mod_def::GL-vs07m37E::E4FzgACRQpWhEOM3LNUCew |
| Show a Ticket Reply |
GET |
/tickets/{{ticketId}}/replies/{{id}} |
conn_mod_def::GL-vtGEVf_E::gBjHyjdARdigM-N1A9s-Ig |
Attachments
| Action |
Method |
Path |
Action id |
| Create Attachment |
POST |
/attachments |
conn_mod_def::GL-vrsfsXQw::KrGag_aHTpGfhagiz2rl9g |
Consequences
| Action |
Method |
Path |
Action id |
| Create Consequence |
POST |
/consequences |
conn_mod_def::GL-vrtnc1IU::UxkUd5NpSFeSKjW2061Y0w |
Filters
| Action |
Method |
Path |
Action id |
| Create Filter |
POST |
/filters |
conn_mod_def::GL-vrv9EDRM::legHgwlXSoSm-e9Kk3rh4A |
Labels
| Action |
Method |
Path |
Action id |
| Fetch Labels |
GET |
/labels |
conn_mod_def::GL-vr17tyLg::j57eIH7WTRaxizig4ssGfQ |
Rules
| Action |
Method |
Path |
Action id |
| Create Rule |
POST |
/rules |
conn_mod_def::GL-vr3U0xT8::4gNTebEtRIWDQRgtPhsU0Q |
TicketsCountReport
| Action |
Method |
Path |
Action id |
| Tickets Count Report |
GET |
/reports/tickets_count |
conn_mod_def::GL-vr4TYqng::pzR1NznpQzeTc6cTxGYy7g |
Teams
| Action |
Method |
Path |
Action id |
| Fetch Teams |
GET |
/teams |
conn_mod_def::GL-vsOp6Snc::lgrQYDLVSY6gqOk2TJRBAw |
TeamAssignment
| Action |
Method |
Path |
Action id |
| Team Assignment for a Ticket |
POST |
/tickets/{{id}}/team_assignment |
conn_mod_def::GL-vsVBHDqM::0rPndQvlTtur7W34wgbW7g |
Replies
| Action |
Method |
Path |
Action id |
| Create a Reply for a Ticket |
POST |
/tickets/{{id}}/replies |
conn_mod_def::GL-vsW__YX4::6BFn5RrGS8WWqAE3d-bV1w |
CustomerGroupMembers
| Action |
Method |
Path |
Action id |
| Fetch Members of a Customer Group |
GET |
/users/{{id}}/members |
conn_mod_def::GL-vtWcId1A::la2-92TpT8u1UAQfCVNwCg |
This lists 39 of 50 actions. For anything not here, call search_one_platform_actions with platform support-bee. The full catalog is at https://www.withone.ai/knowledge/support-bee.
When a call fails
The error comes from SupportBee, 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/support-bee
Integration knowledge by One (withone.ai), licensed under One-Knowledge-1.0. Attribution must be preserved in derivative works.
withoneai