Gorgias through One
Gorgias is a conversational AI platform built for e-commerce brands that centralises support workflows, automates up to 60% of inquiries and transforms customer interactions into sales-driving conversations.
One exposes Gorgias 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 gorgias 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 Gorgias 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 Gorgias 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 |
| List Tickets |
GET |
/api/tickets |
conn_mod_def::GJ309ji_DuI::Ep3PgzwXR1WQN5USq898hA |
| Retrieve a Ticket |
GET |
/api/tickets/{{id}} |
conn_mod_def::GJ30913H0fs::mw2mA3zoRmOW3vCf-JB2TA |
| Add Tags to a Ticket |
POST |
/tickets/{{ticketId}}/tags |
conn_mod_def::GJ308q8M96w::yjo_TGTpTxOJBnx1BIpyow |
| Create a Ticket |
POST |
/api/tickets |
conn_mod_def::GJ308174-bM::omfdYdOCTQGLj6KzLAwttQ |
| Delete a Ticket |
DELETE |
/tickets/{{id}} |
conn_mod_def::GJ308-Me_-4::6m1xtwukQdGG_9hmCV0hnA |
| Delete a Ticket’s Custom Field Value |
DELETE |
/tickets/{{ticketId}}/custom-fields/{{id}} |
conn_mod_def::GJ309HrojWQ::Co30NUbrRjC8uJsqfvggQw |
| Remove Tags from a Ticket |
DELETE |
/tickets/{{ticketId}}/tags |
conn_mod_def::GJ309sSPOik::MQJrpPgoTHWSIV02Mfqj0g |
| Set a Ticket’s Tags |
PUT |
/tickets/{{ticketId}}/tags |
conn_mod_def::GJ309-6K8m4::2di6rc6wTU6DS1evs6sDSw |
| Update a Ticket |
PUT |
/tickets/{{id}} |
conn_mod_def::GJ30-QcUEQc::T4C0IU3ZS7uYAQi8y9WlLQ |
| Update a Ticket’s Custom Field Value |
PUT |
/tickets/{{ticketId}}/custom-fields/{{id}} |
conn_mod_def::GJ30-YYS_9o::ilPnaupGQUuv5kK7Cj17qA |
Customers
| Action |
Method |
Path |
Action id |
| List Customers |
GET |
/api/customers |
conn_mod_def::GJ300rf_yWM::vMrC38u0R7et9BBl1nzR-Q |
| Retrieve a Customer |
GET |
/customers/{{id}} |
conn_mod_def::GJ3009D8EdQ::DCE7fGLWQ3GHGIv2qNUKZg |
| Create a Customer |
POST |
/api/customers |
conn_mod_def::GJ300BEK5VQ::3mnzB4a8Ty2KCzrkr1hECw |
| Delete a Customer |
DELETE |
/api/customers/{{id}} |
conn_mod_def::GJ300IMPd_8::X_j-IboaT8aFo8MG4tdPxg |
| Delete Customers |
DELETE |
/api/customers |
conn_mod_def::GJ300ZgK8mc::zFLyiKiYSg6itICBbsEo2A |
| Merge Two Customers |
PUT |
/customers/merge |
conn_mod_def::GJ3000wJfuc::e_vjZWetTkajcHPl8IgE3A |
| Set a Customer’s Data |
PUT |
/customers/{{customerId}}/data |
conn_mod_def::GJ301E253SA::OezlkLzzRXC_wTpeFGR6hQ |
| Update a Customer |
PUT |
/customers/{{id}} |
conn_mod_def::GJ301M-9GcY::ayoyZ_kaTvif5YhaVpMlCw |
| Update a Customer’s Custom Field Values |
PUT |
/customers/{{customerId}}/custom-fields |
conn_mod_def::GJ301eDBrSs::yT2eBTNrQ9mipucPFQ87gg |
Macros
| Action |
Method |
Path |
Action id |
| List Macros |
GET |
/api/macros |
conn_mod_def::GJ304ASpWpg::D-k0YSuoTZCwFFKESdh-MA |
| Retrieve a Macro |
GET |
/api/macros/{{id}} |
conn_mod_def::GJ304IPNeYY::iiKG1aJHTeCu1vUsNJOcFg |
| Bulk Archive Macros |
PUT |
/api/macros/archive |
conn_mod_def::GJ303mSg6lo::se3lLxxhSeK8aULNNHWfAg |
| Create a Macro |
POST |
/api/api/macros |
conn_mod_def::GJ303tyCsTw::qc6pQB9KR5mZOuaCJk7Mng |
| Delete a Macro |
DELETE |
/api/macros/{{id}} |
conn_mod_def::GJ3031kN6Ik::13u26MXJQzWrSUBd7rMzAg |
| Unarchive Macros |
PUT |
/api/macros/unarchive |
conn_mod_def::GJ304QIs4yk::D02fHNPgR6uDxJf8J4oO2w |
| Update a Macro |
PUT |
/api/macros/{{id}} |
conn_mod_def::GJ304Yk73lg::l0-3iOx9RgKKwvSRE-j9vA |
Tags
| Action |
Method |
Path |
Action id |
| List Tags |
GET |
/api/tags |
conn_mod_def::GJ306qPnG1c::F5JLxOb7RpeROrM8edylow |
| Retrieve a Tag |
GET |
/api/tags/{{id}} |
conn_mod_def::GJ30657k5XM::1mJeo68pStKo8Sl33Cmn7A |
| Create a Tag |
POST |
/api/api/tags |
conn_mod_def::GJ306S70-fQ::84atCYewSuWOWwkhTkrEHQ |
| Delete a Tag |
DELETE |
/tags/{{id}} |
conn_mod_def::GJ306aJBemQ::ZrZDXXdJT4ORGBz6Oh6wXw |
| Delete Tags |
DELETE |
/api/tags |
conn_mod_def::GJ306hlpAoE::bmoAhIopRPWzyHlLDoLzjQ |
| Merge Tags Into a Destination Tag |
PUT |
/tags/{{destinationTagId}}/merge |
conn_mod_def::GJ306yPvj08::mmPJUq4JTPuhax2d3n-z1A |
| Update a Tag |
PUT |
/tags/{{id}} |
conn_mod_def::GJ307BneHwc::rP_aabY_RkeXBorWrLV5KA |
Rules
| Action |
Method |
Path |
Action id |
| List Rules |
GET |
/api/rules |
conn_mod_def::GJ3047LpxaY::zyFtfzDNRUOsUu-Tsh6s0Q |
| Retrieve a Rule |
GET |
/rules/{{id}} |
conn_mod_def::GJ305C-azss::O4nDR5WHTAOe-oCA3kKdGw |
| Create a Rule |
POST |
/api/rules |
conn_mod_def::GJ304p4nmBs::TZKTQMU4T1i7rhPFcKtCKw |
| Delete a Rule |
DELETE |
/rules/{{id}} |
conn_mod_def::GJ304x2XOas::6NHZ9A0hS86vl8M-oxSMag |
| Update a Rule |
PUT |
/api/rules/{{id}} |
conn_mod_def::GJ305LMLonA::6gCdQB1WR12lgL-BX6Wz9A |
| Update Rules' Priorities |
POST |
/api/api/rules/priorities |
conn_mod_def::GJ305TYRhZM::JENJWXGmQCSLYThxypm0Cw |
Teams
| Action |
Method |
Path |
Action id |
| List Teams |
GET |
/api/teams |
conn_mod_def::GJ307aFj6Ws::AQCsIHDvQ2eQJhuG8bOtNA |
| Retrieve a Team |
GET |
/teams/{{id}} |
conn_mod_def::GJ307hhh9-s::vMfTNlm-Tg-yF6uvX8bm9g |
| Create a Team |
POST |
/api/teams |
conn_mod_def::GJ307KPGvRE::F_Sd9dUARbGpeijv2AAPBA |
| Delete a Team |
DELETE |
/teams/{{id}} |
conn_mod_def::GJ307R3A4eY::tN0T2BViSI2ElDpVbi65WQ |
| Update a Team |
PUT |
/api/teams/{{id}} |
conn_mod_def::GJ307pSiOw0::k8cU5VY8SO2g1XB-ierGZA |
TicketMessages
| Action |
Method |
Path |
Action id |
| List a Ticket's Messages (Deprecated) |
GET |
/tickets/{{ticketId}}/messages |
conn_mod_def::GJ308OyAfXg::8UUdVmBzTTaBJiL8nESSQw |
| Retrieve a Ticket Message |
GET |
/tickets/{{ticketId}}/messages/{{id}} |
conn_mod_def::GJ308XSQNeE::Ecv6cMMLSF2iquu-jJkr2A |
| Create a Ticket Message |
POST |
/api/api/tickets/{{ticketId}}/messages |
conn_mod_def::GJ307zSE-RU::-72sJQ0NQcG9UYjR9Zr3Dw |
| Delete a Ticket Message |
DELETE |
/tickets/{{ticketId}}/messages/{{id}} |
conn_mod_def::GJ3078XnJUc::m1eNZ5rpT8epDaVBR2x5UA |
| Update a Ticket’s Message |
PUT |
/tickets/{{ticketId}}/messages/{{id}} |
conn_mod_def::GJ308gY3GTM::s1pXaNy2TdCUHpOJDBWJQw |
Users
| Action |
Method |
Path |
Action id |
| List Users |
GET |
/api/users |
conn_mod_def::GJ30-6u69SI::4iQEj_YCQh-areL7EHmG6Q |
| Retrieve a User |
GET |
/api/users/{{id}} |
conn_mod_def::GJ30_DTjiWg::qGfrdxqBQJ629xG7rqa9Rw |
| Create a User |
POST |
/api/users |
conn_mod_def::GJ30-qlnO_A::EZKjxcxwQKW9OkJYDqIk4Q |
| Delete a User |
DELETE |
/users/{{id}} |
conn_mod_def::GJ30-x5p_bk::Dtd-AhfHSfSY2_QRut7blA |
| Update a User |
PUT |
/users/{{id}} |
conn_mod_def::GJ30_L5I3-0::NMsVz_XCRBGeQHxvc3fRPQ |
Views
| Action |
Method |
Path |
Action id |
| List Views |
GET |
/api/views |
conn_mod_def::GJ30_x5EChA::fMNOOIATSB6jsNSGOPX0xA |
| Retrieve a View |
GET |
/api/views/{{id}} |
conn_mod_def::GJ30_5zaNFI::kglZIep2R56E2qGRkQ8WWQ |
| Create a View |
POST |
/api/views |
conn_mod_def::GJ30_VtnR1w::hFXEXUrjQJG818erWEYBrg |
| Delete a View |
DELETE |
/views/{{id}} |
conn_mod_def::GJ30_eMtnhA::80U_7QQ_RKeCVVLDfqOpwQ |
| Update a View |
PUT |
/api/views/{{id}} |
conn_mod_def::GJ31AOCJX4w::_C1cRhiMSd2VRaC5_ayf1Q |
Widgets
| Action |
Method |
Path |
Action id |
| List Widgets |
GET |
/api/widgets |
conn_mod_def::GJ31Bg7-6Ek::3ZwWpZeoSo-VbYe6ec6Y6Q |
| Retrieve a Widget |
GET |
/api/widgets/{{id}} |
conn_mod_def::GJ31BoqC_WQ::nxNOjjnDSDiVEdOdlPa07w |
| Create a Widget |
POST |
/api/widgets |
conn_mod_def::GJ31BRPOVEk::_H64FInhSneaVPTSGHOIEQ |
| Delete a Widget |
DELETE |
/widgets/{{id}} |
conn_mod_def::GJ31BX5aeaw::AfqghE8sQJC_J3NtK4PmHA |
| Update a Widget |
PUT |
/api/widgets/{{id}} |
conn_mod_def::GJ31Bwxz3cU::B2M8_F8GSJqzaO9l3ttmEQ |
CustomFields
| Action |
Method |
Path |
Action id |
| List Custom Fields |
GET |
/api/custom-fields |
conn_mod_def::GJ30zrOSA34::MYKwm_R7QdGtZRuxENy-iA |
| Retrieve a Custom Field |
GET |
/custom-fields/{{id}} |
conn_mod_def::GJ30zyClOAI::_H6eL4dYQP6h-vFllaGNcQ |
| Bulk Update Custom Fields |
PUT |
/api/custom-fields |
conn_mod_def::GJ30zYuxsjc::oq3Wp2p-TUG5G7L1rzNAfQ |
| Create a Custom Field |
POST |
/api/api/custom-fields |
conn_mod_def::GJ30zhzxW3A::9Bh5cNMrRZy8oBQp6z-m_g |
| Update a Custom Field |
PUT |
/custom-fields/{{id}} |
conn_mod_def::GJ30z5ufXdo::UXGiVlhbRM2BG-l0qMEl5w |
Integrations
| Action |
Method |
Path |
Action id |
| List Integrations |
GET |
/api/integrations |
conn_mod_def::GJ302jK9Y6A::nWuG8IToS_GarJfZNaHJqg |
| Retrieve an Integration |
GET |
/api/integrations/{{id}} |
conn_mod_def::GJ302qfuxQc::kmMeHEDeQSW7velOxLgv5Q |
| Create an Integration |
POST |
/api/api/integrations |
conn_mod_def::GJ302RNrOmM::QdYClYz3TeOao4oYd4vf0A |
| Delete an Integration |
DELETE |
/integrations/{{id}} |
conn_mod_def::GJ302YXIimQ::xF5cbRHEQKyA0FJmbFM5OQ |
| Update an Integration |
PUT |
/api/integrations/{{id}} |
conn_mod_def::GJ302zGG8Uo::IJt0GtibTLywbvk2igy5fg |
Jobs
| Action |
Method |
Path |
Action id |
| List Jobs |
GET |
/api/jobs |
conn_mod_def::GJ303OBdeFk::WLE3aIroRsOeOyZgYeF6pg |
| Retrieve a Job |
GET |
/api/jobs/{{id}} |
conn_mod_def::GJ303Vtrw0Q::TOl3_1kET7OAQyKK2OCmBQ |
| Cancel a Job |
DELETE |
/api/jobs/{{id}} |
conn_mod_def::GJ3026I2P1o::Q1ujnfA0SXGeHOoAcN-qcQ |
| Create a Job |
POST |
/api/jobs |
conn_mod_def::GJ303DmqxJE::nvJgRzlRSr2iTMNrki6g9Q |
| Update a Job |
PUT |
/api/jobs/{{id}} |
conn_mod_def::GJ303eK1gnc::X-5wuT-5SPuVT4WmxKG86g |
SatisfactionSurveys
| Action |
Method |
Path |
Action id |
| List Satisfaction Surveys |
GET |
/api/api/satisfaction-surveys |
conn_mod_def::GJ305kDmVLM::KUY08uUPQPmyLTbRCxjK7g |
| Retrieve a Satisfaction Survey |
GET |
/api/satisfaction-surveys/{{id}} |
conn_mod_def::GJ305rLJwAw::pxZxbailRDmdZFahACdtAA |
| Create a Satisfaction Survey |
POST |
/api/satisfaction-surveys |
conn_mod_def::GJ305a_ku60::pf8Vq1atREa3wXESUXumEQ |
| Update a Satisfaction Survey |
PUT |
/api/satisfaction-surveys/{{id}} |
conn_mod_def::GJ3050ZqQyI::7oH9mGXqSWKkL55yGRSIaQ |
VoiceCallRecordings
| Action |
Method |
Path |
Action id |
| List Voice Call Recordings |
GET |
/api/phone/voice-call-recordings |
conn_mod_def::GJ31Awv_1WQ::pRvmaG3qQue7GuOPD823dA |
| Retrieve a Voice Call Recording |
GET |
/phone/voice-call-recordings/{{id}} |
conn_mod_def::GJ31A4icyjs::WNKBios7RA2-s1oGfNV-mQ |
| Delete a Voice Call Recording |
DELETE |
/phone/voice-call-recordings/{{id}} |
conn_mod_def::GJ31AnD17k8::XXdRyYthShS_p8u4wyszLQ |
AccountSettings
| Action |
Method |
Path |
Action id |
| List Account Settings |
GET |
/api/account/settings |
conn_mod_def::GJ30zA6KYvk::CeJyFwfrQj-7R_DAvpiXkw |
| Create an Account Setting |
POST |
/api/account/settings |
conn_mod_def::GJ30y5k1A7Q::yYD4NB39Qj2SNYOTMCY6Qg |
| Update an Account Setting |
PUT |
/account/settings/{{id}} |
conn_mod_def::GJ30zRLULAk::5gvBFf-OSHWxA8G2zP2p2A |
Stats
| Action |
Method |
Path |
Action id |
| Download a Statistic CSV Export |
POST |
/stats/{{name}}/download |
conn_mod_def::GJ306C8X-Aw::GCFqNnTzSEurYgnZsvQ7_g |
1 more Stats actions are available through search.
This lists 90 of 111 actions. For anything not here, call search_one_platform_actions with platform gorgias. The full catalog is at https://www.withone.ai/knowledge/gorgias.
When a call fails
The error comes from Gorgias, 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/gorgias
Integration knowledge by One (withone.ai), licensed under One-Knowledge-1.0. Attribution must be preserved in derivative works.
withoneai