# Support Bee

> SupportBee through One

- Skill: `withoneai/support-bee` (Agent Skill)
- Install (CLI): `npx skillmds@latest add withoneai/support-bee`
- Raw SKILL.md: https://api.skillmd.com/api/skills/withoneai/support-bee/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: withoneai (https://skillmd.com/u/withoneai)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/withoneai/support-bee

---


# 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

1. Find the action in the table below, or call `search_one_platform_actions` with platform `support-bee` 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 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](https://www.withone.ai/licenses/knowledge). Attribution must be preserved in derivative works.

