gorgias

name

gorgias

description

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. Read and write Gorgias data through One: tickets, customers, macros, tags, rules, teams and more, 111 actions with real parameter documentation. Use whenever the user asks to look something up in Gorgias, create or update a record there, or build code against the Gorgias API.

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

1. Find the action in the table below, or call search_one_platform_actions with platform gorgias 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 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.