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

# Gorgias

> A helpdesk and live chat app for managing customer support, tickets, customers, teams, and automation via your connected account.

Use Gorgias when you need to manage support tickets, customer records, or team workflows from another step. Pick actions like List Tickets, Get Ticket, Send Ticket Message, or Add Ticket Tags when you have ticket IDs or customer details already.

## Configuration

| Option | Required | Description |
| - | - | - |
| Name | No | Label for the step in the workflow canvas. |
| Authentication | Yes | The connected Gorgias account to use for this step. |
| Action | Yes | The Gorgias action to perform (for example List Tickets, Get Ticket, Create Ticket, Update Ticket). |
| Arguments | Yes | Per-action form fields generated from the action's schema. Each text field has an **Insert Variable** button for injecting `{{placeholder}}` values. A **Raw JSON** tab is available for advanced usage. |
| When the step fails | No | Controls whether the workflow should **Terminate Workflow** or **Continue** if this step fails. |

Before you configure this step, connect Gorgias in **Integrations** for your workspace using the sign-in flow. If no active connection is available, the step shows a warning with a link to **Integrations** instead of the account selector.

## Arguments form

When you select an action, the **Arguments** section renders a form driven by the action's input schema. Fields that refer to existing records include dropdown pickers.

Switch to the **Raw JSON** tab when you prefer to write the full arguments object by hand. Changes in either tab stay in sync.

## Common actions

| Action | Description |
| - | - |
| **List Tickets** | Lists tickets in Gorgias with various filtering options. |
| **Get Ticket** | Retrieves a specific ticket from Gorgias. |
| **Create Ticket** | Creates a new ticket in Gorgias. |
| **Update Ticket** | Updates an existing ticket in Gorgias. |
| **List Messages** | Lists messages in Gorgias, optionally filtered by ticket. |
| **Send Ticket Message** | Sends an externally delivered message on an existing Gorgias ticket. |
| **List Customers** | Lists customers in Gorgias with various filtering options. |
| **Get Customer** | Retrieves a specific customer from Gorgias. |
| **Create Customer** | Creates a new customer in Gorgias. |
| **Update Customer** | Updates an existing customer. |
| **List Teams** | Lists teams in Gorgias. |
| **Get Team** | Retrieves a specific team from Gorgias. |
| **List Views** | Lists saved ticket views, optionally filtered by category. |

Destructive actions, such as deleting records, are not available in the workflow action picker.

## Output

This step stores the Gorgias response as the step output. The shape of the response depends on the action.

Use the full output reference in later steps:

```text theme={null}
{{STEP_IDENTIFIER.output}}
```

## Example

1. Open **Integrations** and connect Gorgias if you have not already done that.
2. Add a **Gorgias** step to your workflow.
3. Select a connected account in **Authentication**.
4. Choose **List Tickets** in **Action**.
5. Fill in the required fields. Use **Insert Variable** to reference an earlier step's output for any field value.
6. Click **Run** in the step header to test the action, then review the returned payload in **Output**.

## Use cases

### Reply to an open ticket

1. List Tickets
2. Get Ticket
3. Send Ticket Message

### Tag a customer issue

1. List Tickets
2. Get Ticket
3. List Tags
4. Add Ticket Tags

### Create and route a customer

1. Create Customer
2. Create Ticket
3. List Teams
4. Update Ticket

## Notes

* This step depends on a connected Gorgias integration in your workspace.
* The workflow action picker shows a curated set of actions. Agents with the Gorgias tool can use more of them.
* The sign-in screen may show third-party authorization branding.

## Using Gorgias as an Agent Tool

You can also add Gorgias as a tool in the **Agent Editor**. Open the agent, click **Add tool**, and select **Gorgias**. In the tool settings panel, choose the connected account the agent should use. The agent calls Gorgias actions when they are relevant to the conversation.

See also: [Integrations](https://docs.fetchhive.com/workspace/integrations.md), [Creating and Editing](https://docs.fetchhive.com/workflows/creating-and-editing.md), and [Testing and Iteration](https://docs.fetchhive.com/workflows/testing-and-iteration.md)


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