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

# Gorgias

> What agents can do in Gorgias with standard access, and how to connect, limit, and disconnect Gorgias.

Connect Gorgias so your agents can work in your Gorgias account.

## Access levels

Gorgias has one level. The connect window shows it as **Default** and describes it as "Standard access." Agents can use all 32 Gorgias actions.

You cannot choose a narrower level for Gorgias. You can block single agents with **No access** under **Per-agent access**.

The Gorgias sign-in page asks you to approve full access to your account. This is expected. Squad does not narrow the sign-in, and standard access does not limit which Gorgias actions agents can use.

## What agents can do

The summary below groups the Gorgias actions into plain tasks. The full list after it names every action, grouped by what the action works on. You do not need to name actions. Ask in plain words, and the agent searches for the matching action.

<Tip>**Find an action.** Open the list and use your browser's find (Ctrl+F, or Cmd+F on a Mac) with a word from the task or part of a slug. Or ask your agent in plain words, for example "What can you do in my Gorgias account?" The agent can search the Gorgias actions for you.</Tip>

Each action shows its name, a one-line description where the Gorgias action catalog has one, and its slug. The slug is the ID that agents use when they call the action.

* View, create, update, and delete customers
* View, create, update, and delete teams
* View, create, update, and delete tickets
* View, create, update, and delete tags
* View, create, and update settings
* View events
* View account details

<AccordionGroup>
  <Accordion title="All 32 Gorgias actions">
    <AccordionGroup>
      <Accordion title="Account details (1)">
        | Action      | What it does                                | Slug                  |
        | ----------- | ------------------------------------------- | --------------------- |
        | Get account | Retrieves your Gorgias account information. | `GORGIAS_GET_ACCOUNT` |
      </Accordion>

      <Accordion title="Customers (8)">
        | Action            | What it does                                                       | Slug                        |
        | ----------------- | ------------------------------------------------------------------ | --------------------------- |
        | Create customer   | Creates a new customer in Gorgias.                                 | `GORGIAS_CREATE_CUSTOMER`   |
        | Delete customer   | Deletes a specific customer from Gorgias.                          | `GORGIAS_DELETE_CUSTOMER`   |
        | Delete customers  | Deletes multiple customers from Gorgias.                           | `GORGIAS_DELETE_CUSTOMERS`  |
        | Get customer      | Retrieves a specific customer from Gorgias.                        | `GORGIAS_GET_CUSTOMER`      |
        | List customers    | Lists customers in Gorgias with various filtering options.         | `GORGIAS_LIST_CUSTOMERS`    |
        | Merge customers   | Merges two customers in Gorgias, combining their data and history. | `GORGIAS_MERGE_CUSTOMERS`   |
        | Set customer data | Sets the complete data object for a customer in Gorgias.           | `GORGIAS_SET_CUSTOMER_DATA` |
        | Update customer   | Updates an existing customer in Gorgias.                           | `GORGIAS_UPDATE_CUSTOMER`   |
      </Accordion>

      <Accordion title="Events (2)">
        | Action      | What it does                                            | Slug                  |
        | ----------- | ------------------------------------------------------- | --------------------- |
        | Get event   | Retrieves a specific event from Gorgias.                | `GORGIAS_GET_EVENT`   |
        | List events | Lists events in Gorgias with various filtering options. | `GORGIAS_LIST_EVENTS` |
      </Accordion>

      <Accordion title="Fields (4)">
        | Action                      | What it does                                              | Slug                                  |
        | --------------------------- | --------------------------------------------------------- | ------------------------------------- |
        | Delete customer field value | Deletes a specific field value for a customer in Gorgias. | `GORGIAS_DELETE_CUSTOMER_FIELD_VALUE` |
        | Delete ticket field value   | Deletes a specific field value for a ticket in Gorgias.   | `GORGIAS_DELETE_TICKET_FIELD_VALUE`   |
        | List customer field values  | Lists all field values for a customer in Gorgias.         | `GORGIAS_LIST_CUSTOMER_FIELD_VALUES`  |
        | List ticket field values    | Lists all field values for a ticket in Gorgias.           | `GORGIAS_LIST_TICKET_FIELD_VALUES`    |
      </Accordion>

      <Accordion title="Settings (3)">
        | Action                 | What it does                                    | Slug                             |
        | ---------------------- | ----------------------------------------------- | -------------------------------- |
        | Create account setting | Creates a new account setting in Gorgias.       | `GORGIAS_CREATE_ACCOUNT_SETTING` |
        | List account settings  | Lists all account settings in Gorgias.          | `GORGIAS_LIST_ACCOUNT_SETTINGS`  |
        | Update account setting | Updates an existing account setting in Gorgias. | `GORGIAS_UPDATE_ACCOUNT_SETTING` |
      </Accordion>

      <Accordion title="Tags (4)">
        | Action             | What it does                                            | Slug                         |
        | ------------------ | ------------------------------------------------------- | ---------------------------- |
        | Add ticket tags    | Adds tags to a ticket in Gorgias.                       | `GORGIAS_ADD_TICKET_TAGS`    |
        | List ticket tags   | Lists all tags for a ticket in Gorgias.                 | `GORGIAS_LIST_TICKET_TAGS`   |
        | Remove ticket tags | Removes tags from a ticket in Gorgias.                  | `GORGIAS_REMOVE_TICKET_TAGS` |
        | Set ticket tags    | Sets the complete list of tags for a ticket in Gorgias. | `GORGIAS_SET_TICKET_TAGS`    |
      </Accordion>

      <Accordion title="Teams (5)">
        | Action      | What it does                            | Slug                  |
        | ----------- | --------------------------------------- | --------------------- |
        | Create team | Creates a new team in Gorgias.          | `GORGIAS_CREATE_TEAM` |
        | Delete team | Deletes a specific team from Gorgias.   | `GORGIAS_DELETE_TEAM` |
        | Get team    | Retrieves a specific team from Gorgias. | `GORGIAS_GET_TEAM`    |
        | List teams  | Lists teams in Gorgias.                 | `GORGIAS_LIST_TEAMS`  |
        | Update team | Updates an existing team in Gorgias.    | `GORGIAS_UPDATE_TEAM` |
      </Accordion>

      <Accordion title="Tickets (5)">
        | Action        | What it does                                             | Slug                    |
        | ------------- | -------------------------------------------------------- | ----------------------- |
        | Create ticket | Creates a new ticket in Gorgias.                         | `GORGIAS_CREATE_TICKET` |
        | Delete ticket | Deletes a specific ticket from Gorgias.                  | `GORGIAS_DELETE_TICKET` |
        | Get ticket    | Retrieves a specific ticket from Gorgias.                | `GORGIAS_GET_TICKET`    |
        | List tickets  | Lists tickets in Gorgias with various filtering options. | `GORGIAS_LIST_TICKETS`  |
        | Update ticket | Updates an existing ticket in Gorgias.                   | `GORGIAS_UPDATE_TICKET` |
      </Accordion>
    </AccordionGroup>
  </Accordion>
</AccordionGroup>

## Connect Gorgias

Before you start:

* You need a Gorgias account that you can sign in to.
* Your Squad subscription must be active. Squad does not connect apps while the subscription is not active.

<Steps>
  <Step title="Open Integrations">
    Open **Settings** > **Integrations**.
  </Step>

  <Step title="Add an integration">
    On the **Connected apps** tab, click **+ Add integration**.
  </Step>

  <Step title="Find Gorgias">
    Find **Gorgias** in the catalog and click it. You can type the name in **Search the catalog…**.
  </Step>

  <Step title="Keep the default level">
    Under **Default scope**, keep **Default**. It is the only option.
  </Step>

  <Step title="Click Connect Gorgias">
    Click **Connect Gorgias**. The Gorgias sign-in page opens in a new tab.
  </Step>

  <Step title="Sign in to Gorgias">
    Sign in to Gorgias and approve the request.
  </Step>
</Steps>

Check that it works: Gorgias shows under **YOUR CONNECTIONS**, with a row for the account and its access level.

## Set access for one agent

Every agent can use the account unless you block it.

1. Under **YOUR CONNECTIONS**, open the account menu (⋯) on the Gorgias account.
2. Click **Manage scope**.
3. Under **Per-agent access**, find the agent.
4. Choose **No access** to block the agent. Choose **Default (Default)** to allow it again.
5. Click **Save access**.

Changes apply from the agent's next call. An agent with **No access** does not see the account.

## Use more than one Gorgias account

Click **+ Account** on the Gorgias card to connect another account. Agents use the primary account unless they are asked to use a specific one.

* After you click **+ Account**, follow the connect steps above.
* The first account you connect becomes the primary account. It shows **★ PRIMARY**.
* To change the primary account, open the account menu (⋯) and click **Make primary**.
* To tell accounts apart, open the account menu (⋯) and click **Rename**.

## Reconnect or disconnect

Reconnect when the connection has expired, or when you need to change what the account can reach on the Gorgias side:

1. Open the account menu (⋯) and click **Reconnect**.
2. Click **Reauthorize on Gorgias**.
3. Sign in to Gorgias and approve the request.

Reconnect signs in to the same account again. It does not add a second connection.

Open the account menu (⋯) on the Gorgias account and click **Disconnect**. Agents lose access to that account at once.

<Warning>**Disconnect** acts at once, with no confirmation step. If it was the primary account, another connected Gorgias account becomes primary.</Warning>

## Costs

Gorgias actions do not use Squad credits. Connected apps never use credits. For what does use credits, see [What Squad costs](/docs/costs).

## Troubleshooting

An agent says it has no access to Gorgias, or it does not see the account.

* Cause: the agent is set to **No access** under **Per-agent access**, or the account is not connected.
* Fix: open **Manage scope** and change the agent's row. If the account is missing, connect it again.

Connecting or saving fails with "Your subscription isn't active."

* Cause: your Squad subscription is not active.
* Fix: resubscribe. See [Manage your subscription](/docs/billing).

An agent says the Gorgias connection has expired.

* Cause: the sign-in for that account is no longer valid.
* Fix: use **Reconnect** on the account.

## Common questions

<AccordionGroup>
  <Accordion title="Can I limit what agents can do in Gorgias?">
    You cannot choose a narrower level for Gorgias. You can block single agents with **No access** under **Per-agent access**.
  </Accordion>

  <Accordion title="Can I connect more than one Gorgias account?">
    Click **+ Account** on the Gorgias card to connect another account. Agents use the primary account unless they are asked to use a specific one.
  </Accordion>

  <Accordion title="How do I disconnect Gorgias?">
    Open the account menu (⋯) on the Gorgias account and click **Disconnect**. Agents lose access to that account at once.
  </Accordion>
</AccordionGroup>

## Related pages

<CardGroup cols={2}>
  <Card title="Connect apps" icon="plug" href="/docs/integrations" />

  <Card title="Add an MCP server or an API key" icon="server" href="/docs/custom-integrations">
    Use this when an action you need is not in this app.
  </Card>
</CardGroup>
