# Gorgias

Your Toolhouse AI Worker can connect to Gorgias using 32 specialized tools.

## Auth Connection

This service requires an auth connection to use its tools. You can set this up in your Toolhouse dashboard under [Auth Connections](https://toolhouse.app/auth-connections?authkit_slugs=gorgias).

## Tools (32)

### `Gorgias Add Ticket Tags`

Integration name: **GORGIAS\_ADD\_TICKET\_TAGS**

Adds tags to a ticket in Gorgias.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter   | Type    | Required | Example | Description                          |
| ----------- | ------- | :------: | ------- | ------------------------------------ |
| `tag_ids`   | array   |     ✅    | —       | List of tag IDs to add to the ticket |
| `ticket_id` | integer |     ✅    | —       | The ID of the ticket                 |

### `Gorgias Create Account Setting`

Integration name: **GORGIAS\_CREATE\_ACCOUNT\_SETTING**

Creates a new account setting in Gorgias.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter     | Type   | Required | Example | Description                |
| ------------- | ------ | :------: | ------- | -------------------------- |
| `name`        | string |     ✅    | —       | The name of the setting    |
| `value`       | string |     ✅    | —       | The value of the setting   |
| `description` | string |          | —       | Description of the setting |

### `Gorgias Create Customer`

Integration name: **GORGIAS\_CREATE\_CUSTOMER**

Creates a new customer in Gorgias.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter     | Type   | Required | Example | Description                           |
| ------------- | ------ | :------: | ------- | ------------------------------------- |
| `data`        | object |          | —       | Additional customer data              |
| `name`        | string |     ✅    | —       | The customer's full name              |
| `email`       | string |          | —       | The customer's email address          |
| `address`     | object |          | —       | The customer's address information    |
| `channels`    | array  |          | —       | The customer's communication channels |
| `external_id` | string |          | —       | External identifier for the customer  |

### `Gorgias Create Team`

Integration name: **GORGIAS\_CREATE\_TEAM**

Creates a new team in Gorgias.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter     | Type   | Required | Example | Description                                           |
| ------------- | ------ | :------: | ------- | ----------------------------------------------------- |
| `name`        | string |     ✅    | —       | Name of the team                                      |
| `members`     | array  |          | —       | The list of users within the team                     |
| `decoration`  | object |          | —       | Object describing how the team appears on the webpage |
| `description` | string |          | —       | Longer description of the team                        |

### `Gorgias Create Ticket`

Integration name: **GORGIAS\_CREATE\_TICKET**

Creates a new ticket in Gorgias.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter          | Type    | Required | Example | Description                                                                |
| ------------------ | ------- | :------: | ------- | -------------------------------------------------------------------------- |
| `via`              | string  |     ✅    | —       | How the first message of the ticket has been received or sent from Gorgias |
| `meta`             | object  |          | —       | Extra metadata about the ticket                                            |
| `tags`             | array   |          | —       | List of tag IDs to apply to the ticket                                     |
| `status`           | string  |          | —       | The status of the ticket                                                   |
| `channel`          | string  |          | —       | The channel of the ticket (email, chat, etc.)                              |
| `subject`          | string  |          | —       | The subject of the ticket                                                  |
| `customer`         | object  |          | —       | Customer information (id, name, or email)                                  |
| `language`         | string  |          | —       | The language of the ticket                                                 |
| `messages`         | array   |     ✅    | —       | Messages of the ticket                                                     |
| `priority`         | string  |          | —       | The priority of the ticket                                                 |
| `external_id`      | string  |          | —       | External identifier for the ticket                                         |
| `assignee_team_id` | integer |          | —       | ID of the team to assign the ticket to                                     |
| `assignee_user_id` | integer |          | —       | ID of the user to assign the ticket to                                     |

### `Gorgias Delete Customer`

Integration name: **GORGIAS\_DELETE\_CUSTOMER**

Deletes a specific customer from Gorgias.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter     | Type    | Required | Example | Description                      |
| ------------- | ------- | :------: | ------- | -------------------------------- |
| `customer_id` | integer |     ✅    | —       | The ID of the customer to delete |

### `Gorgias Delete Customer Field Value`

Integration name: **GORGIAS\_DELETE\_CUSTOMER\_FIELD\_VALUE**

Deletes a specific field value for a customer in Gorgias.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter     | Type    | Required | Example | Description                |
| ------------- | ------- | :------: | ------- | -------------------------- |
| `field_id`    | integer |     ✅    | —       | The ID of the custom field |
| `customer_id` | integer |     ✅    | —       | The ID of the customer     |

### `Gorgias Delete Customers`

Integration name: **GORGIAS\_DELETE\_CUSTOMERS**

Deletes multiple customers from Gorgias.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter      | Type  | Required | Example | Description                    |
| -------------- | ----- | :------: | ------- | ------------------------------ |
| `customer_ids` | array |     ✅    | —       | List of customer IDs to delete |

### `Gorgias Delete Team`

Integration name: **GORGIAS\_DELETE\_TEAM**

Deletes a specific team from Gorgias.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter | Type    | Required | Example | Description                  |
| --------- | ------- | :------: | ------- | ---------------------------- |
| `team_id` | integer |     ✅    | —       | The ID of the team to delete |

### `Gorgias Delete Ticket`

Integration name: **GORGIAS\_DELETE\_TICKET**

Deletes a specific ticket from Gorgias.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter   | Type    | Required | Example | Description                    |
| ----------- | ------- | :------: | ------- | ------------------------------ |
| `ticket_id` | integer |     ✅    | —       | The ID of the ticket to delete |

### `Gorgias Delete Ticket Field Value`

Integration name: **GORGIAS\_DELETE\_TICKET\_FIELD\_VALUE**

Deletes a specific field value for a ticket in Gorgias.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter   | Type    | Required | Example | Description                |
| ----------- | ------- | :------: | ------- | -------------------------- |
| `field_id`  | integer |     ✅    | —       | The ID of the custom field |
| `ticket_id` | integer |     ✅    | —       | The ID of the ticket       |

### `Gorgias Get Account`

Integration name: **GORGIAS\_GET\_ACCOUNT**

Retrieves your Gorgias account information.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

*No parameters required.*

### `Gorgias Get Customer`

Integration name: **GORGIAS\_GET\_CUSTOMER**

Retrieves a specific customer from Gorgias.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter     | Type    | Required | Example | Description                        |
| ------------- | ------- | :------: | ------- | ---------------------------------- |
| `customer_id` | integer |     ✅    | —       | The ID of the customer to retrieve |

### `Gorgias Get Event`

Integration name: **GORGIAS\_GET\_EVENT**

Retrieves a specific event from Gorgias.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter  | Type    | Required | Example | Description                     |
| ---------- | ------- | :------: | ------- | ------------------------------- |
| `event_id` | integer |     ✅    | —       | The ID of the event to retrieve |

### `Gorgias Get Team`

Integration name: **GORGIAS\_GET\_TEAM**

Retrieves a specific team from Gorgias.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter | Type    | Required | Example | Description                    |
| --------- | ------- | :------: | ------- | ------------------------------ |
| `team_id` | integer |     ✅    | —       | The ID of the team to retrieve |

### `Gorgias Get Ticket`

Integration name: **GORGIAS\_GET\_TICKET**

Retrieves a specific ticket from Gorgias.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter   | Type    | Required | Example | Description                      |
| ----------- | ------- | :------: | ------- | -------------------------------- |
| `ticket_id` | integer |     ✅    | —       | The ID of the ticket to retrieve |

### `Gorgias List Account Settings`

Integration name: **GORGIAS\_LIST\_ACCOUNT\_SETTINGS**

Lists all account settings in Gorgias.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter | Type    | Required | Example | Description                                          |
| --------- | ------- | :------: | ------- | ---------------------------------------------------- |
| `limit`   | integer |          | —       | Number of settings to return (default: 20, max: 100) |
| `offset`  | integer |          | —       | Offset for pagination                                |

### `Gorgias List Customer Field Values`

Integration name: **GORGIAS\_LIST\_CUSTOMER\_FIELD\_VALUES**

Lists all field values for a customer in Gorgias.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter     | Type    | Required | Example | Description            |
| ------------- | ------- | :------: | ------- | ---------------------- |
| `customer_id` | integer |     ✅    | —       | The ID of the customer |

### `Gorgias List Customers`

Integration name: **GORGIAS\_LIST\_CUSTOMERS**

Lists customers in Gorgias with various filtering options.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter      | Type    | Required | Example | Description                                           |
| -------------- | ------- | :------: | ------- | ----------------------------------------------------- |
| `name`         | string  |          | —       | Filter by customer name                               |
| `email`        | string  |          | —       | Filter by customer email                              |
| `limit`        | integer |          | —       | Number of customers to return (default: 20, max: 100) |
| `offset`       | integer |          | —       | Offset for pagination                                 |
| `order_by`     | string  |          | —       | Field to order by (e.g., 'created\_datetime')         |
| `order_dir`    | string  |          | —       | Order direction ('asc' or 'desc')                     |
| `created_to`   | string  |          | —       | Filter by creation date (ISO format)                  |
| `external_id`  | string  |          | —       | Filter by external ID                                 |
| `created_from` | string  |          | —       | Filter by creation date (ISO format)                  |

### `Gorgias List Events`

Integration name: **GORGIAS\_LIST\_EVENTS**

Lists events in Gorgias with various filtering options.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter      | Type    | Required | Example | Description                            |
| -------------- | ------- | :------: | ------- | -------------------------------------- |
| `type`         | string  |          | —       | Filter by event type                   |
| `limit`        | integer |          | —       | Number of events to return ( max: 100) |
| `offset`       | integer |          | —       | Offset for pagination                  |
| `context`      | string  |          | —       | Filter by context UUID                 |
| `user_id`      | integer |          | —       | Filter by user ID                      |
| `object_id`    | integer |          | —       | Filter by object ID                    |
| `created_to`   | string  |          | —       | Filter by creation date (ISO format)   |
| `object_type`  | string  |          | —       | Filter by object type                  |
| `created_from` | string  |          | —       | Filter by creation date (ISO format)   |

### `Gorgias List Teams`

Integration name: **GORGIAS\_LIST\_TEAMS**

Lists teams in Gorgias.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter | Type    | Required | Example | Description                                                                                                  |
| --------- | ------- | :------: | ------- | ------------------------------------------------------------------------------------------------------------ |
| `limit`   | integer |          | —       | Maximum number of teams to return per page (default: 20, max: 100).                                          |
| `cursor`  | string  |          | —       | Cursor for pagination. Use the value of 'meta.next\_cursor' from a previous response to fetch the next page. |

### `Gorgias List Ticket Field Values`

Integration name: **GORGIAS\_LIST\_TICKET\_FIELD\_VALUES**

Lists all field values for a ticket in Gorgias.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter   | Type    | Required | Example | Description          |
| ----------- | ------- | :------: | ------- | -------------------- |
| `ticket_id` | integer |     ✅    | —       | The ID of the ticket |

### `Gorgias List Tickets`

Integration name: **GORGIAS\_LIST\_TICKETS**

Lists tickets in Gorgias with various filtering options.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter          | Type    | Required | Example | Description                                         |
| ------------------ | ------- | :------: | ------- | --------------------------------------------------- |
| `limit`            | integer |          | —       | Number of tickets to return (default: 20, max: 100) |
| `offset`           | integer |          | —       | Offset for pagination                               |
| `status`           | string  |          | —       | Filter by ticket status                             |
| `tag_id`           | integer |          | —       | Filter by tag ID                                    |
| `channel`          | string  |          | —       | Filter by ticket channel                            |
| `language`         | string  |          | —       | Filter by language                                  |
| `order_by`         | string  |          | —       | Field to order by (e.g., 'created\_datetime')       |
| `priority`         | string  |          | —       | Filter by ticket priority                           |
| `order_dir`        | string  |          | —       | Order direction ('asc' or 'desc')                   |
| `created_to`       | string  |          | —       | Filter by creation date (ISO format)                |
| `updated_to`       | string  |          | —       | Filter by update date (ISO format)                  |
| `customer_id`      | integer |          | —       | Filter by customer ID                               |
| `external_id`      | string  |          | —       | Filter by external ID                               |
| `created_from`     | string  |          | —       | Filter by creation date (ISO format)                |
| `updated_from`     | string  |          | —       | Filter by update date (ISO format)                  |
| `assignee_team_id` | integer |          | —       | Filter by assigned team ID                          |
| `assignee_user_id` | integer |          | —       | Filter by assigned user ID                          |

### `Gorgias List Ticket Tags`

Integration name: **GORGIAS\_LIST\_TICKET\_TAGS**

Lists all tags for a ticket in Gorgias.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter   | Type    | Required | Example | Description          |
| ----------- | ------- | :------: | ------- | -------------------- |
| `ticket_id` | integer |     ✅    | —       | The ID of the ticket |

### `Gorgias Merge Customers`

Integration name: **GORGIAS\_MERGE\_CUSTOMERS**

Merges two customers in Gorgias, combining their data and history.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter            | Type    | Required | Example | Description                                                    |
| -------------------- | ------- | :------: | ------- | -------------------------------------------------------------- |
| `source_customer_id` | integer |     ✅    | —       | The ID of the source customer (will be merged into the target) |
| `target_customer_id` | integer |     ✅    | —       | The ID of the target customer (will remain after merge)        |

### `Gorgias Remove Ticket Tags`

Integration name: **GORGIAS\_REMOVE\_TICKET\_TAGS**

Removes tags from a ticket in Gorgias.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter   | Type    | Required | Example | Description                               |
| ----------- | ------- | :------: | ------- | ----------------------------------------- |
| `tag_ids`   | array   |     ✅    | —       | List of tag IDs to remove from the ticket |
| `ticket_id` | integer |     ✅    | —       | The ID of the ticket                      |

### `Gorgias Set Customer Data`

Integration name: **GORGIAS\_SET\_CUSTOMER\_DATA**

Sets the complete data object for a customer in Gorgias.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter     | Type    | Required | Example | Description                                      |
| ------------- | ------- | :------: | ------- | ------------------------------------------------ |
| `data`        | object  |     ✅    | —       | The complete data object to set for the customer |
| `customer_id` | integer |     ✅    | —       | The ID of the customer                           |

### `Gorgias Set Ticket Tags`

Integration name: **GORGIAS\_SET\_TICKET\_TAGS**

Sets the complete list of tags for a ticket in Gorgias.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter   | Type    | Required | Example | Description                           |
| ----------- | ------- | :------: | ------- | ------------------------------------- |
| `tag_ids`   | array   |     ✅    | —       | List of tag IDs to set for the ticket |
| `ticket_id` | integer |     ✅    | —       | The ID of the ticket                  |

### `Gorgias Update Account Setting`

Integration name: **GORGIAS\_UPDATE\_ACCOUNT\_SETTING**

Updates an existing account setting in Gorgias.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter     | Type    | Required | Example | Description                        |
| ------------- | ------- | :------: | ------- | ---------------------------------- |
| `value`       | string  |     ✅    | —       | The new value of the setting       |
| `setting_id`  | integer |     ✅    | —       | The ID of the setting to update    |
| `description` | string  |          | —       | Updated description of the setting |

### `Gorgias Update Customer`

Integration name: **GORGIAS\_UPDATE\_CUSTOMER**

Updates an existing customer in Gorgias.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter     | Type    | Required | Example | Description                           |
| ------------- | ------- | :------: | ------- | ------------------------------------- |
| `data`        | object  |          | —       | Additional customer data              |
| `name`        | string  |          | —       | The customer's full name              |
| `email`       | string  |          | —       | The customer's email address          |
| `address`     | object  |          | —       | The customer's address information    |
| `channels`    | array   |          | —       | The customer's communication channels |
| `customer_id` | integer |     ✅    | —       | The ID of the customer to update      |
| `external_id` | string  |          | —       | External identifier for the customer  |

### `Gorgias Update Team`

Integration name: **GORGIAS\_UPDATE\_TEAM**

Updates an existing team in Gorgias.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter     | Type    | Required | Example | Description                                           |
| ------------- | ------- | :------: | ------- | ----------------------------------------------------- |
| `name`        | string  |          | —       | Name of the team                                      |
| `members`     | array   |          | —       | The list of users within the team                     |
| `team_id`     | integer |     ✅    | —       | The ID of the team to update                          |
| `decoration`  | object  |          | —       | Object describing how the team appears on the webpage |
| `description` | string  |          | —       | Longer description of the team                        |

### `Gorgias Update Ticket`

Integration name: **GORGIAS\_UPDATE\_TICKET**

Updates an existing ticket in Gorgias.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter          | Type    | Required | Example | Description                            |
| ------------------ | ------- | :------: | ------- | -------------------------------------- |
| `meta`             | object  |          | —       | Extra metadata about the ticket        |
| `status`           | string  |          | —       | The status of the ticket               |
| `subject`          | string  |          | —       | The subject of the ticket              |
| `language`         | string  |          | —       | The language of the ticket             |
| `priority`         | string  |          | —       | The priority of the ticket             |
| `ticket_id`        | integer |     ✅    | —       | The ID of the ticket to update         |
| `customer_id`      | integer |          | —       | The ID of the customer for this ticket |
| `external_id`      | string  |          | —       | External identifier for the ticket     |
| `assignee_team_id` | integer |          | —       | ID of the team to assign the ticket to |
| `assignee_user_id` | integer |          | —       | ID of the user to assign the ticket to |


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.toolhouse.ai/toolhouse/integrations/gorgias.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
