> For the complete documentation index, see [llms.txt](https://docs.toolhouse.ai/toolhouse/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.toolhouse.ai/toolhouse/integrations/gorgias.md).

# 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 |
