---
updatedAt: 2026-06-05T18:04:24.000Z
---

# Setting up Gorgias as a Source 

Connecting Gorgias as a Source in Guru lets you sync your Gorgias tickets, messages, users, and teams into Guru. This makes it easy to generate AI-powered Answers from your customer support data, helping your team find the right information quickly without switching apps.

<Callout icon="👥" theme="default">
  #### Access Required

  **Guru Access:** You need to be an Admin, Source Creator, or relevant [custom role](https://app.getguru.com/manage/team/custom-roles) to set up Sources

  **Gorgias Access:** You do not need to be a Gorgias Admin to set up this source.
</Callout>

***

## Setting up Gorgias as a Source

1. Go to **Manage > Sources** in the Guru web app.
2. Select **Gorgias** from the list of available Source integrations.
3. Enter your Gorgias subdomain when prompted (e.g., **yourcompany**.gorgias.com).
4. Select **Authorize Access** to connect Guru with your Gorgias account.
5. Grant Guru permission to access your Gorgias tickets, messages, users, and teams.
6. Select the Guru Groups that should have access to this Source’s content.
7. Optionally, assign a Source Owner to manage this connection.
8. Click **Connect Source** to start syncing.

***

## What gets synced

Primary objects are the objects used to generate the search record.

<Table align={["left","left","left"]}>
  <thead>
    <tr>
      <th>
        **Common Model / What You'll See During Setup**
      </th>

      <th>
        **Objects/Data Brought In**
      </th>

      <th>
        **Key Fields**
      </th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>
        Ticket
      </td>

      <td>
        **Primary Object:**
        Gorgias support tickets/conversations
      </td>

      <td>
        • Name • Description • Status (Enum) • Priority (Enum) • Ticket URL • Completed at • Contact (UUID) • Assignees (Array) • Tags (Array) • Remote created at • Remote updated at • Remote ID • Remote data
      </td>
    </tr>

    <tr>
      <td>
        Comment
      </td>

      <td>
        Public messages and internal notes on tickets
      </td>

      <td>
        • HTML body • Body • User (UUID) • Ticket (UUID) • Contact (UUID) • Is private (Boolean) • Remote created at • Remote ID • Remote data
      </td>
    </tr>

    <tr>
      <td>
        Attachment
      </td>

      <td>
        File attachments on messages
      </td>

      <td>
        • File name • File URL • Content type • Uploaded by (UUID) • Ticket (UUID) • Remote created at • Remote ID • Remote data
      </td>
    </tr>

    <tr>
      <td>
        Contact
      </td>

      <td>
        Customer contacts
      </td>

      <td>
        • Name • Email address • Details • Remote ID • Remote data
      </td>
    </tr>

    <tr>
      <td>
        User
      </td>

      <td>
        Gorgias agents/support staff
      </td>

      <td>
        • Name • Email address • Is active (Boolean) • Teams (Array) • Remote ID • Remote data
      </td>
    </tr>

    <tr>
      <td>
        Team
      </td>

      <td>
        Agent teams
      </td>

      <td>
        • Name • Description • Remote ID • Remote data
      </td>
    </tr>

    <tr>
      <td>
        Tag
      </td>

      <td>
        Ticket tags/labels
      </td>

      <td>
        • Name • Remote ID • Remote data
      </td>
    </tr>
  </tbody>
</Table>

## Permissions

* When you connect Gorgias as a source in Guru, you'll permission that content in Guru. Learn more [here](https://help.getguru.com/docs/permissioning-knowledge-in-guru#/).
* If someone is not provided with access in Guru to this source, they will not see Gorgias results in searches or when chatting with Guru.