Gorgias
Handle e-commerce support tickets and customer messages in Gorgias via the Gorgias REST API.
What It Does
Connects to a Gorgias helpdesk account to read support tickets, look up customers, and post reply messages. Useful for automation workflows that need to pull open ticket data, check customer records, or close the loop on a support conversation.
Authentication
Gorgias uses HTTP Basic authentication. The username is your Gorgias account email and the password is an API key.
- Log in to your Gorgias account.
- Go to Settings > REST API.
- Click Create API key and copy the key.
- Supply your subdomain (the
{domain}part ofhttps://{domain}.gorgias.com), your account email, and the API key as tool inputs.
No OAuth flow is required — a single API key is sufficient.
Operations
| operation | Method | Endpoint | Required extra inputs |
|---|---|---|---|
list_tickets |
GET | /api/tickets |
— |
get_ticket |
GET | /api/tickets/{ticketId} |
ticketId |
list_customers |
GET | /api/customers |
— |
create_message |
POST | /api/tickets/{ticketId}/messages |
ticketId, messageBody |
Inputs
| Name | Required | Description |
|---|---|---|
apiKey |
yes | Gorgias API key |
operation |
yes | One of: list_tickets, get_ticket, list_customers, create_message |
domain |
yes | Your Gorgias subdomain (e.g. mystore) |
email |
yes | Gorgias account email (Basic auth username) |
ticketId |
for get_ticket, create_message |
Numeric ticket ID |
limit |
no | Page size 1-100 (default 30) for list operations |
cursor |
no | Pagination cursor returned by a previous list call |
orderBy |
no | Sort for list_tickets: created_datetime:asc, created_datetime:desc, updated_datetime:asc, or updated_datetime:desc |
customerEmail |
no | Filter list_customers by email address |
messageBody |
for create_message |
Plain-text or HTML body of the reply |
senderEmail |
no | Sender email for create_message (defaults to email) |
Outputs
| Name | Description |
|---|---|
result |
Full JSON response body from the Gorgias API |
status |
HTTP status code as a string (e.g. "200", "201") |
Examples
List open tickets (most recent first):
operation: list_tickets
domain: mystore
email: [email protected]
apiKey: <key>
orderBy: created_datetime:desc
limit: 10
Fetch a specific ticket:
operation: get_ticket
domain: mystore
email: [email protected]
apiKey: <key>
ticketId: 12345
Post a reply to ticket 12345:
operation: create_message
domain: mystore
email: [email protected]
apiKey: <key>
ticketId: 12345
messageBody: "Hi! Your order has shipped. Tracking: 1Z999AA10123456784"
Search customers by email:
operation: list_customers
domain: mystore
email: [email protected]
apiKey: <key>
customerEmail: [email protected]