Gorgias

At a glance

Availability: Experimental (how to enable).
Authentication: Basic auth.
Connection: HTTP Basic auth with GORGIAS_USERNAME as the username and GORGIAS_API_KEY as the password.
Provider documentation: Authentication reference.

Credentials

Set these per environment. See Connect an integration.

Variable	Required	Description
`GORGIAS_USERNAME`	Yes	Email address of the Gorgias account the API key belongs to (HTTP Basic username) Docs.
`GORGIAS_API_KEY`	Yes	Gorgias REST API key (HTTP Basic password), created under Settings → REST API Docs.
`GORGIAS_ACCOUNT_DOMAIN`	Yes	Your Gorgias account subdomain, e.g. ‘acme’ for acme.gorgias.com - passed as the accountDomain parameter on every tool Docs.

Setup

Get a Gorgias account: Sign up at https://www.gorgias.com - new accounts start with a free trial you can use for testing. Note your account subdomain (the ‘acme’ in acme.gorgias.com).
Create a REST API key: In your Gorgias dashboard, open Settings → REST API. Copy the Base API URL (https://<your-domain>.gorgias.com/api), your username (your account email), and create/copy the API key (password).
Store the credentials: Add GORGIAS_USERNAME=<your account email>, GORGIAS_API_KEY=<your API key>, and GORGIAS_ACCOUNT_DOMAIN=<your subdomain> to your .env file. The API uses HTTP Basic auth with email as username and API key as password.
Verify access: Run the List Tickets tool with your account subdomain as accountDomain. You should get back a page of tickets (empty data array on a fresh account).

Provider notes

Every tool takes an accountDomain path parameter - pass the value stored in GORGIAS_ACCOUNT_DOMAIN
API keys inherit the permissions of the user they belong to; create the key from an account with access to the tickets you need
Creating a message with channel ‘email’ actually emails the customer - use channel ‘internal-note’ for private notes

Provider API reference.

Tools

Tool	Access	Description
List Tickets `gorgias__list_tickets`	Read	List helpdesk tickets, optionally filtered by customer or ordered by creation/update time
Get Ticket `gorgias__get_ticket`	Read	Retrieve a single ticket with its full details (customer, assignee, status, tags)
List Ticket Messages `gorgias__list_ticket_messages`	Read	List the messages (customer and agent) in a ticket’s conversation thread
Create Ticket Message `gorgias__create_ticket_message`	Write	Add a message to a ticket, e.g. an agent reply to the customer or an internal note
Create Ticket `gorgias__create_ticket`	Write	Create a new helpdesk ticket with an initial message, e.g. to open an issue on behalf of a customer
List Customers `gorgias__list_customers`	Read	List or search helpdesk customers, e.g. to find a customer ID by email for ticket filtering
List Users `gorgias__list_users`	Read	List helpdesk agents/users, e.g. to find the user IDs needed for ticket assignment and message senders
Update Ticket Status `gorgias__update_ticket_status`	Write	Update a ticket, e.g. close or reopen it, or change its assignee

Verify the connection

Call a read tool such as gorgias__list_tickets with arguments for your account. Confirm that the result comes from the intended account or workspace before enabling write tools.

Get started

APIs

REST API

GraphQL API

MCP API

At a glance

Credentials

Setup

Provider notes

Tools

Verify the connection

​At a glance

​Credentials

​Setup

​Provider notes

​Tools

​Verify the connection

At a glance

Credentials

Setup

Provider notes

Tools

Verify the connection