> ## Documentation Index
> Fetch the complete documentation index at: https://nango-wari-integration-config-credentials-api.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Gorgias

## Overview

<CardGroup cols={3}>
  <Card title="Pre-built tooling" icon="screwdriver-wrench" href="#pre-built-tooling" />

  <Card title="Pre-built integrations" icon="square-check" href="#pre-built-integrations" />

  <Card title="Access requirements" icon="triangle-exclamation" href="#access-requirements" />

  <Card title="Setup guide" icon="rocket" href="#setup-guide" />

  <Card title="Useful links" icon="circle-info" href="#useful-links" />

  <Card title="API gotchas" icon="biohazard" href="#api-gotchas" />
</CardGroup>

## Pre-built tooling

<AccordionGroup>
  <Accordion title="✅ Authorization">
    | Tools                           | Status |
    | ------------------------------- | ------ |
    | Pre-built authorization (OAuth) | ✅      |
    | Credentials auto-refresh        | ✅      |
    | Auth parameters validation      | ✅      |
    | Pre-built authorization UI      | ✅      |
    | Custom authorization UI         | ✅      |
    | Expired credentials detection   | ✅      |
  </Accordion>

  <Accordion title="✅ Read & write data">
    | Tools                                     | Status                         |
    | ----------------------------------------- | ------------------------------ |
    | Pre-built integrations                    | ✅                              |
    | API unification                           | ✅                              |
    | 2-way sync                                | ✅                              |
    | Webhooks from Nango on data modifications | ✅                              |
    | Real-time webhooks from 3rd-party API     | 🚫 (time to contribute: \<48h) |
    | Proxy requests                            | ✅                              |
  </Accordion>

  <Accordion title="✅ Observability & data quality">
    | Tools                   | Status |
    | ----------------------- | ------ |
    | HTTP request logging    | ✅      |
    | End-to-end type safety  | ✅      |
    | Data runtime validation | ✅      |
    | OpenTelemetry export    | ✅      |
    | Slack alerts on errors  | ✅      |
    | Integration status API  | ✅      |
  </Accordion>

  <Accordion title="✅ Customization">
    | Tools                              | Status                         |
    | ---------------------------------- | ------------------------------ |
    | Create or customize use-cases      | ✅                              |
    | Pre-configured pagination          | 🚫 (time to contribute: \<48h) |
    | Pre-configured rate-limit handling | 🚫 (time to contribute: \<48h) |
    | Per-customer configurations        | ✅                              |
  </Accordion>
</AccordionGroup>

### Others

| Function name                         | Description                                                                                                                                                 | Type                                           | Source code                                                                                                                                 |
| ------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------- |
| `add-ticket-tags`                     | Add one or more existing tags to a ticket (additive, does not remove existing tags).                                                                        | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/gorgias/actions/add-ticket-tags.ts)                     |
| `bulk-update-custom-fields`           | Bulk update custom field definitions.                                                                                                                       | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/gorgias/actions/bulk-update-custom-fields.ts)           |
| `cancel-job`                          | Cancel a pending/running bulk-operation job                                                                                                                 | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/gorgias/actions/cancel-job.ts)                          |
| `create-custom-field`                 | Create a custom field definition for tickets or customers.                                                                                                  | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/gorgias/actions/create-custom-field.ts)                 |
| `create-customer`                     | Create a customer with one or more contact channels.                                                                                                        | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/gorgias/actions/create-customer.ts)                     |
| `create-macro`                        | Create a macro with one or more actions (e.g. setResponseText).                                                                                             | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/gorgias/actions/create-macro.ts)                        |
| `create-rule`                         | Create an automation rule with JavaScript-like condition/action code.                                                                                       | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/gorgias/actions/create-rule.ts)                         |
| `create-satisfaction-survey`          | Create a satisfaction survey record for a ticket and customer.                                                                                              | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/gorgias/actions/create-satisfaction-survey.ts)          |
| `create-tag`                          | Create a tag.                                                                                                                                               | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/gorgias/actions/create-tag.ts)                          |
| `create-team`                         | Create a team.                                                                                                                                              | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/gorgias/actions/create-team.ts)                         |
| `create-ticket-message`               | Add a new message to an existing ticket.                                                                                                                    | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/gorgias/actions/create-ticket-message.ts)               |
| `create-ticket`                       | Create a ticket, finding or creating the customer by email/phone and choosing the phone vs. email message channel based on account settings.                | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/gorgias/actions/create-ticket.ts)                       |
| `create-user`                         | Create a new user with a role in Gorgias. Defaults to agent if a role is not provided.                                                                      | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/gorgias/actions/create-user.ts)                         |
| `create-view`                         | Create a view (saved filter) for tickets or customers.                                                                                                      | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/gorgias/actions/create-view.ts)                         |
| `delete-customer-custom-field-value`  | Clear a single custom field value on a customer.                                                                                                            | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/gorgias/actions/delete-customer-custom-field-value.ts)  |
| `delete-customer`                     | Delete a customer.                                                                                                                                          | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/gorgias/actions/delete-customer.ts)                     |
| `delete-macro`                        | Delete a macro                                                                                                                                              | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/gorgias/actions/delete-macro.ts)                        |
| `delete-rule`                         | Delete a rule.                                                                                                                                              | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/gorgias/actions/delete-rule.ts)                         |
| `delete-tag`                          | Delete a tag.                                                                                                                                               | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/gorgias/actions/delete-tag.ts)                          |
| `delete-tags`                         | Delete multiple tags in one call.                                                                                                                           | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/gorgias/actions/delete-tags.ts)                         |
| `delete-team`                         | Delete a team                                                                                                                                               | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/gorgias/actions/delete-team.ts)                         |
| `delete-ticket-custom-field-value`    | Clear a single custom field value on a ticket                                                                                                               | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/gorgias/actions/delete-ticket-custom-field-value.ts)    |
| `delete-ticket-message`               | Delete a message from a ticket.                                                                                                                             | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/gorgias/actions/delete-ticket-message.ts)               |
| `delete-ticket`                       | Delete a ticket.                                                                                                                                            | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/gorgias/actions/delete-ticket.ts)                       |
| `delete-user`                         | Delete a user in Gorgias.                                                                                                                                   | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/gorgias/actions/delete-user.ts)                         |
| `delete-view`                         | Delete a view.                                                                                                                                              | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/gorgias/actions/delete-view.ts)                         |
| `get-account`                         | Get details about the current Gorgias account.                                                                                                              | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/gorgias/actions/get-account.ts)                         |
| `get-custom-field`                    | Retrieve a single custom field definition.                                                                                                                  | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/gorgias/actions/get-custom-field.ts)                    |
| `get-customer`                        | Retrieve a single customer, including their contact channels.                                                                                               | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/gorgias/actions/get-customer.ts)                        |
| `get-event`                           | Retrieve a single event.                                                                                                                                    | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/gorgias/actions/get-event.ts)                           |
| `get-integration`                     | Retrieve a single integration's configuration.                                                                                                              | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/gorgias/actions/get-integration.ts)                     |
| `get-job`                             | Retrieve a single job's status/progress.                                                                                                                    | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/gorgias/actions/get-job.ts)                             |
| `get-macro`                           | Retrieve a single macro.                                                                                                                                    | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/gorgias/actions/get-macro.ts)                           |
| `get-rule`                            | Retrieve a single automation rule, including its code and parsed AST.                                                                                       | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/gorgias/actions/get-rule.ts)                            |
| `get-satisfaction-survey`             | Retrieve a single satisfaction survey.                                                                                                                      | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/gorgias/actions/get-satisfaction-survey.ts)             |
| `get-stats-overview`                  | Retrieve a named statistic over a date range.                                                                                                               | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/gorgias/actions/get-stats-overview.ts)                  |
| `get-tag`                             | Retrieve a single tag.                                                                                                                                      | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/gorgias/actions/get-tag.ts)                             |
| `get-team`                            | Retrieve a single team.                                                                                                                                     | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/gorgias/actions/get-team.ts)                            |
| `get-ticket-message`                  | Retrieve a single message on a ticket.                                                                                                                      | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/gorgias/actions/get-ticket-message.ts)                  |
| `get-ticket`                          | Retrieve a single ticket, including its full messages array.                                                                                                | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/gorgias/actions/get-ticket.ts)                          |
| `get-user`                            | Retrieve a single user.                                                                                                                                     | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/gorgias/actions/get-user.ts)                            |
| `get-view`                            | Retrieve a single view.                                                                                                                                     | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/gorgias/actions/get-view.ts)                            |
| `list-account-settings`               | List account-level settings (business hours, ticket assignment, satisfaction survey config, access/SSO, auto-merge, auto-split, default integration, etc.). | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/gorgias/actions/list-account-settings.ts)               |
| `list-custom-fields`                  | List custom field definitions for tickets or customers.                                                                                                     | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/gorgias/actions/list-custom-fields.ts)                  |
| `list-customer-custom-field-values`   | List all custom field values set on a customer.                                                                                                             | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/gorgias/actions/list-customer-custom-field-values.ts)   |
| `list-customers`                      | List customers, optionally filtered by email, name, external ID, language, timezone, view, or channel.                                                      | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/gorgias/actions/list-customers.ts)                      |
| `list-events`                         | List account audit-trail events, filterable by object type/ID, event types, user, and creation-date range.                                                  | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/gorgias/actions/list-events.ts)                         |
| `list-integrations`                   | List configured integrations (email senders, HTTP integrations, apps, etc.) on the account.                                                                 | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/gorgias/actions/list-integrations.ts)                   |
| `list-jobs`                           | List bulk-operation jobs (e.g., bulk delete/export), filterable by status and type.                                                                         | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/gorgias/actions/list-jobs.ts)                           |
| `list-macros`                         | List macros (canned response templates), optionally searched, filtered by tags/language/archived state, or ranked by relevance to a ticket/message.         | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/gorgias/actions/list-macros.ts)                         |
| `list-rules`                          | List automation rules, optionally searched.                                                                                                                 | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/gorgias/actions/list-rules.ts)                          |
| `list-satisfaction-surveys`           | List satisfaction surveys, optionally filtered by ticket.                                                                                                   | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/gorgias/actions/list-satisfaction-surveys.ts)           |
| `list-tags`                           | List tags, optionally searched or ordered by usage.                                                                                                         | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/gorgias/actions/list-tags.ts)                           |
| `list-teams`                          | List teams.                                                                                                                                                 | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/gorgias/actions/list-teams.ts)                          |
| `list-ticket-custom-field-values`     | List all custom field values set on a ticket.                                                                                                               | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/gorgias/actions/list-ticket-custom-field-values.ts)     |
| `list-ticket-messages`                | List messages on a specific ticket                                                                                                                          | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/gorgias/actions/list-ticket-messages.ts)                |
| `list-ticket-tags`                    | List tags currently applied to a ticket.                                                                                                                    | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/gorgias/actions/list-ticket-tags.ts)                    |
| `list-tickets`                        | List tickets, optionally filtered by customer, view, rule, or specific IDs.                                                                                 | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/gorgias/actions/list-tickets.ts)                        |
| `list-users`                          | List users (agents/admins/bots), optionally filtered by role, email, or search term.                                                                        | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/gorgias/actions/list-users.ts)                          |
| `list-view-items`                     | List the tickets or customers matching a view's saved filter.                                                                                               | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/gorgias/actions/list-view-items.ts)                     |
| `list-views`                          | List views (saved ticket/customer filter definitions), optionally filtered to system or user-created views.                                                 | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/gorgias/actions/list-views.ts)                          |
| `merge-customers`                     | Merge one customer into another, deleting the source customer.                                                                                              | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/gorgias/actions/merge-customers.ts)                     |
| `merge-tags`                          | Merge one or more source tags into a destination tag.                                                                                                       | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/gorgias/actions/merge-tags.ts)                          |
| `remove-ticket-tags`                  | Remove one or more tags from a ticket.                                                                                                                      | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/gorgias/actions/remove-ticket-tags.ts)                  |
| `search`                              | Search across agents, customers, customer channels/profiles, integrations, teams, or tags by a text query.                                                  | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/gorgias/actions/search.ts)                              |
| `set-customer-data`                   | Set arbitrary structured JSON data on a customer data field.                                                                                                | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/gorgias/actions/set-customer-data.ts)                   |
| `set-ticket-tags`                     | Replace a ticket's full tag list with the given set of existing tags.                                                                                       | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/gorgias/actions/set-ticket-tags.ts)                     |
| `unarchive-macros`                    | Unarchive up to 30 macros in one call.                                                                                                                      | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/gorgias/actions/unarchive-macros.ts)                    |
| `update-custom-field`                 | Update a custom field definition, or deactivate it.                                                                                                         | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/gorgias/actions/update-custom-field.ts)                 |
| `update-customer-custom-field-value`  | Set a single custom field value on a customer.                                                                                                              | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/gorgias/actions/update-customer-custom-field-value.ts)  |
| `update-customer-custom-field-values` | Set multiple custom field values on a customer in one call.                                                                                                 | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/gorgias/actions/update-customer-custom-field-values.ts) |
| `update-customer`                     | Update a customer's fields (name, email, channels, language, timezone, external ID).                                                                        | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/gorgias/actions/update-customer.ts)                     |
| `update-macro`                        | Update a macro's name, actions, tags, or language.                                                                                                          | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/gorgias/actions/update-macro.ts)                        |
| `update-rule-priorities`              | Reorder the execution priority of multiple rules in one call.                                                                                               | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/gorgias/actions/update-rule-priorities.ts)              |
| `update-rule`                         | Update a rule's name, code, or description.                                                                                                                 | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/gorgias/actions/update-rule.ts)                         |
| `update-satisfaction-survey`          | Update a satisfaction survey (e.g. record a customer's score).                                                                                              | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/gorgias/actions/update-satisfaction-survey.ts)          |
| `update-tag`                          | Rename a tag or change its decoration or description.                                                                                                       | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/gorgias/actions/update-tag.ts)                          |
| `update-team`                         | Update a team's name or description.                                                                                                                        | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/gorgias/actions/update-team.ts)                         |
| `update-ticket-custom-field-value`    | Set a single custom field value on a ticket.                                                                                                                | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/gorgias/actions/update-ticket-custom-field-value.ts)    |
| `update-ticket-custom-field-values`   | Set multiple custom field values on a ticket in one call.                                                                                                   | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/gorgias/actions/update-ticket-custom-field-values.ts)   |
| `update-ticket-message`               | Update a message's fields (e.g. body\_text/body\_html).                                                                                                     | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/gorgias/actions/update-ticket-message.ts)               |
| `update-ticket`                       | Update a ticket's fields (subject, status, priority, assignee, tags, channel, custom fields, etc.).                                                         | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/gorgias/actions/update-ticket.ts)                       |
| `update-user`                         | Update a user's fields (name, email, role, bio, etc.).                                                                                                      | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/gorgias/actions/update-user.ts)                         |
| `update-view`                         | Update a view's fields.                                                                                                                                     | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/gorgias/actions/update-view.ts)                         |
| `custom-fields`                       | Sync custom field definitions for both tickets and customers                                                                                                | [Sync](/guides/functions/syncs/sync-functions) | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/gorgias/syncs/custom-fields.ts)                         |
| `customers`                           | Sync customers and their contact channels.                                                                                                                  | [Sync](/guides/functions/syncs/sync-functions) | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/gorgias/syncs/customers.ts)                             |
| `events`                              | Sync the account's audit-trail events (ticket/customer/user/tag/rule/etc. lifecycle events).                                                                | [Sync](/guides/functions/syncs/sync-functions) | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/gorgias/syncs/events.ts)                                |
| `integrations`                        | Sync configured integrations (email senders, HTTP integrations, apps, etc.)                                                                                 | [Sync](/guides/functions/syncs/sync-functions) | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/gorgias/syncs/integrations.ts)                          |
| `macros`                              | Sync macros (canned response templates).                                                                                                                    | [Sync](/guides/functions/syncs/sync-functions) | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/gorgias/syncs/macros.ts)                                |
| `rules`                               | Sync automation rules.                                                                                                                                      | [Sync](/guides/functions/syncs/sync-functions) | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/gorgias/syncs/rules.ts)                                 |
| `satisfaction-surveys`                | Sync satisfaction surveys.                                                                                                                                  | [Sync](/guides/functions/syncs/sync-functions) | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/gorgias/syncs/satisfaction-surveys.ts)                  |
| `tags`                                | Sync tags.                                                                                                                                                  | [Sync](/guides/functions/syncs/sync-functions) | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/gorgias/syncs/tags.ts)                                  |
| `teams`                               | Sync teams.                                                                                                                                                 | [Sync](/guides/functions/syncs/sync-functions) | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/gorgias/syncs/teams.ts)                                 |
| `ticket-messages`                     | Sync messages across all tickets.                                                                                                                           | [Sync](/guides/functions/syncs/sync-functions) | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/gorgias/syncs/ticket-messages.ts)                       |
| `tickets`                             | Sync tickets with their full messages.                                                                                                                      | [Sync](/guides/functions/syncs/sync-functions) | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/gorgias/syncs/tickets.ts)                               |
| `users`                               | Sync users (agents/admins/bots).                                                                                                                            | [Sync](/guides/functions/syncs/sync-functions) | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/gorgias/syncs/users.ts)                                 |
| `views`                               | Sync views (saved ticket/customer filter definitions), including built-in system views.                                                                     | [Sync](/guides/functions/syncs/sync-functions) | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/gorgias/syncs/views.ts)                                 |

## Access requirements

| Pre-Requisites    | Status | Comment |
| ----------------- | ------ | ------- |
| Paid dev account  | ❓      |         |
| Paid test account | ❓      |         |
| Partnership       | ❓      |         |
| App review        | ❓      |         |
| Security audit    | ❓      |         |

## Setup guide

*No setup guide yet.*

<Tip>Need help getting started? Get help in the [community](https://nango.dev/slack).</Tip>

<Note>Contribute improvements to the setup guide by [editing this page](https://github.com/nangohq/nango/tree/master/docs/integrations/all/gorgias.mdx)</Note>

## Useful links

* [How to register an Application](https://developers.gorgias.com/docs/1-register-on-developer-portal)
* [OAuth-related docs](https://developers.gorgias.com/docs/oauth2-authentication-for-creating-apps-with-gorgias)
* [List of OAuth scopes](https://developers.gorgias.com/docs/oauth2-scopes)
* [Web API docs (their REST API)](https://developers.gorgias.com/reference/introduction)

<Note>Contribute useful links by [editing this page](https://github.com/nangohq/nango/tree/master/docs/integrations/all/gorgias.mdx)</Note>

## Connection configuration in Nango

* Gorgias requires a user specific subdomain to run OAuth.

## API gotchas

* To refresh tokens, you will need to set the `offline` as part of the scopes when creating an integration.

<Note>Contribute API gotchas by [editing this page](https://github.com/nangohq/nango/tree/master/docs/integrations/all/gorgias.mdx)</Note>
