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

# Gorgias OAuth 2.0 connector profile – StackOne setup guide

> Set up a connector profile using OAuth 2.0 for Gorgias in StackOne to allow users to link their accounts.

> [!WARNING]
>
> You need a Gorgias Partners account to create an app. It is separate from your Gorgias helpdesk sign-in.

Select Actions to adjust the guideSome actions may require additional configuration in the provider to be accessible. Choose the actions you need and the guide will be updated.

Select all
Clear

ActionScope(s)

Loading actions...No actions match your search.

Dynamic Guide URL

Copy URL

Scopes Selected

<pre role="textbox" aria-readonly="true" tabIndex="0" />

Separator

Copy scopes

## Create a Gorgias app

A Gorgias app provides the Client ID and Client Secret for your Connector Profile. The app stays in **Draft** status, and App Store review is not required to connect.

**1. Fill in the app details**

Sign in to the [Gorgias Partners portal](https://partners.gorgias.com/login), then on the **My Apps** page click **Create New App**.

<ul>
  <li>**App name**: `StackOne Integration`</li>
  <li>**App tagline**: Short description shown beneath the app name</li>
  <li>**App URL**: Your company website</li>
  <li>**Redirect URLs**: the **Callback URL** from your Connector Profile</li>
</ul>

![The Create New App form with the App name, App tagline, App Icon, App URL, Redirect URLs fields and the Create button highlighted](https://mintcdn.com/stackone-60/KJSCzuGbWQ9fkVcT/connectors/gorgias/images/oauth2-setup-create-app.png?fit=max\&auto=format\&n=KJSCzuGbWQ9fkVcT\&q=85\&s=f0e84e0c0fe9f5d0d3d013185f0827e4)

**2. Upload the icon and create the app**

Under **App Icon**, upload a `.png` or `.jpg` image for the app.

<ul>
  <li>Click **Choose File** and select the image.</li>
  <li>In the **Edit Image** dialog, click **Confirm**.</li>
  <li>Click **Create**.</li>
</ul>

![The Edit Image dialog for the app icon with the Confirm button highlighted](https://mintcdn.com/stackone-60/KJSCzuGbWQ9fkVcT/connectors/gorgias/images/oauth2-setup-app-icon.png?fit=max\&auto=format\&n=KJSCzuGbWQ9fkVcT\&q=85\&s=fc983954decd4f45f46db5b8f4365d98)

**3. Copy credentials**

On the **My Apps** page, click the app name to open **Edit app**. The **0. OAuth2** section shows the credentials.

<ul>
  <li>Click **Copy to clipboard** next to **Client ID** and copy it into your Connector Profile.</li>
  <li>Click **Copy to clipboard** next to **Client Secret** and copy it into your Connector Profile.</li>
</ul>

![The 0. OAuth2 section of the Edit app page with the Copy to clipboard buttons for Client ID and Client Secret highlighted](https://mintcdn.com/stackone-60/KJSCzuGbWQ9fkVcT/connectors/gorgias/images/oauth2-setup-copy-credentials.png?fit=max\&auto=format\&n=KJSCzuGbWQ9fkVcT\&q=85\&s=1d6acd91a3ecba85cd0f1aef1593c232)

**4. Review the scopes**

Enables actions: Add Tags To Ticket, Archive Macros, Create Customer, Create Integration, Create Macro, Create Message, Create Rule, Create Tag, Create Team, Create Ticket, Create User, Create View, Delete Customer, Delete Customer Custom Field, Delete Customers, Delete Integration, Delete Macro, Delete Message, Delete Rule, Delete Tag, Delete Tags, Delete Team, Delete Ticket, Delete User, Delete View, Get Account, Get Customer, Get Integration, Get Macro, Get Message, Get Rule, Get Tag, Get Team, Get Ticket, Get User, Get View, List Customer Custom Fields, List Customers, List Integrations, List Macros, List Messages, List Rules, List Settings, List Tags, List Teams, List Ticket Tags, List Tickets, List Users, List View Items, List Views, Merge Customers, Merge Tags, Remove Tags From Ticket, Search View Items, Set Customer Data, Set Ticket Tags, Unarchive Macros, Update Customer, Update Customer Custom Fields, Update Integration, Update Macro, Update Message, Update Rule, Update Rules Priorities, Update Tag, Update Team, Update Ticket, Update User, Update View

Gorgias has no scope settings on the app, so there is nothing to enable in the Partners portal. The scopes listed are the ones the connection requests, together with `openid` and `offline`.

<ul>
  <li>
    account:read
  </li>

  <li>
    users:read
  </li>

  <li>
    users:write
  </li>

  <li>
    customers:read
  </li>

  <li>
    customers:write
  </li>

  <li>
    tickets:read
  </li>

  <li>
    tickets:write
  </li>

  <li>
    integrations:read
  </li>

  <li>
    integrations:write
  </li>

  <li>
    macros:read
  </li>

  <li>
    macros:write
  </li>

  <li>
    rules:read
  </li>

  <li>
    rules:write
  </li>

  <li>
    tags:read
  </li>

  <li>
    tags:write
  </li>
</ul>

## Create the StackOne Connector Profile

**1. Create a Connector Profile**

Enable the connector and create a Connector Profile in your project. See [Setup Connector Profile](https://docs.stackone.com/gateway/quickstart.md#setup-connector-profile).

**2. Link an Account**

Once the Connector Profile is created, continue to [link an account](https://docs.stackone.com/connectors/gorgias/guides/link-account/oauth-2-0.md).


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