> ## Documentation Index
> Fetch the complete documentation index at: https://docs.marina.cloud/llms.txt
> Use this file to discover all available pages before exploring further.

# Gorgias

> Connect a Gorgias helpdesk with an API key.

## Setup

Create an API key in Gorgias under Settings → REST API. Marina reads as that agent.

Add the connection under **Settings -> Connections**. Saving verifies it with a read-only test call.

## Configuration

| Field | Required | Description |
| - | - | - |
| Helpdesk subdomain | Yes | The part before .gorgias.com. |

## Operations

All operations are read-only. Apps declare the ones they use per connection; see [Using connections in apps](/connections/overview).

| Operation | Description |
| - | - |
| `account.get` | Fetch the helpdesk account. |
| `tickets.list` | List tickets, optionally scoped to a customer, a view, an external id, or a set of ticket ids. |
| `ticket.get` | Fetch one ticket by id. |
| `tickets.search` | Full-text search across tickets (subjects, messages, and participants). |
| `messages.list` | List the messages of one ticket. |
| `customers.list` | List customers, optionally filtered by email, name, or external id. |
| `customer.get` | Fetch one customer by id. |
| `tags.list` | List tags, optionally matching a name search. |
| `users.list` | List helpdesk agents and users, optionally filtered by role, email, or search. |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.