How to create OAuth2 credential for Gorgias

3 min read

In this guide, I will share the process for customizing the auth config for Gorgias. So, let’s begin.

Setting up Gorgias

In this section, we’ll go through the process of setting up Gorgias and creating an OAuth2 application.

NOTE: If you already have a Gorgias app and access to the Client ID and Client Secret, you can skip this section.

Step 1: Create a Gorgias App

  1. Go to the Gorgias Partner Portal and click Create New App.

  2. Enter your App name (e.g., Composio Integration), an App tagline, an App icon, and your App URL.

Gorgias Partner Portal - My Apps, Create New App

Step 2: Configure the Redirect URL

On the create app form, find the Redirect URLs field.

Paste the following Composio callback URL:

Click Create to save your app.

Gorgias Create New App form with Redirect URL

Step 3: Add OAuth Scopes

Gorgias scopes define what your app can do or access on behalf of a user.

You’ll need to select the scopes that match your integration’s functionality. For example:

  • To read tickets → tickets:read

  • To create or update tickets → tickets:write

  • To read customer info → customers:read

Scopes Supported by Composio

Instead of manually guessing the scopes in Gorgias, use the scopes that Composio supports for Gorgias.

Scopes supported by Composio:

Below are all the scopes that Composio supports for Gorgias. You can select these based on your integration needs:

These define what actions your Gorgias integration can take.

Always include only the ones necessary for your workflow, for example, if your agent only needs to read tickets, tickets:read alone might be enough.

Step 4: Get Your OAuth Credentials

Once you’ve created your Gorgias app, you can find your OAuth credentials on the app’s page:

  1. Open your app in the Partner Portal.

  2. Locate the Client ID and Client Secret.

Copy the Client ID and Client Secret, as you’ll need them for Composio.

Gorgias OAuth2 Client ID and Client Secret (redacted)

Creating the Auth Config in Composio

With your Gorgias credentials ready, navigate to the Composio Dashboard.

  1. Click on Create Auth Config.

  2. From the toolkit list, select Gorgias.

  3. Ensure the authentication type is set to OAuth2.

  4. Check Use your own developer authentication if using your custom Gorgias app.

  5. Click Create Gorgias Auth Config.

Composio Auth Configs - Gorgias (OAuth2)

Step 5: Fill in OAuth Details

In the Manage Auth Config section, fill in the fields:

  • Client ID → from Gorgias app

  • Client Secret → from Gorgias app

  • Redirect URI →

  • Scopes → use the Composio-supported scopes listed above.

  • Click Create Gorgias Auth Config.

Composio Gorgias auth config with Connect Account

Now connect to your Gorgias account by clicking on “Connect Account” and entering your Gorgias subdomain (the part before .gorgias.com — for acme.gorgias.com, enter acme).

Composio Connect to Gorgias - enter subdomain

Base URL for Gorgias API

All Gorgias API calls are made via:

That’s it! Your Gorgias + Composio OAuth integration is ready.

You can now copy the Auth Config ID (ac_...) and use it inside your code or secret manager.

Share