Composio powers 1000+ toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.
| 1 | ## How do I connect Gorgias with Composio-managed OAuth? |
| 2 | |
| 3 | With managed OAuth you don't need your own Gorgias app or client credentials. The flow starts in Gorgias and finishes in Composio. |
| 4 | |
| 5 | 1. In Gorgias, go to **Settings** > **App Store** > **All Apps**, search for **Composio**, open it, and click **Authorize**. |
| 6 | |
| 7 |  |
| 8 | |
| 9 |  |
| 10 | 2. In the Composio dashboard, open your project's **Toolkits** page, search for **Gorgias**, and click **Add to Project**. |
| 11 | |
| 12 |  |
| 13 | 3. Name the auth config, click **Next**, choose **OAuth 2.0** > **Composio Managed**, and click **Create Gorgias Auth Config**. |
| 14 | |
| 15 |  |
| 16 | |
| 17 |  |
| 18 | 4. Open the auth config and click **Connect Account**. Enter your Gorgias subdomain: for `acme.gorgias.com`, enter `acme`. |
| 19 | |
| 20 |  |
| 21 | 5. Review the Gorgias permission screen, click **Authorize**, and confirm the account shows as **Active** in Composio. |
| 22 | |
| 23 | ## How do I set up custom OAuth credentials for Gorgias? |
| 24 | |
| 25 | Use your own Gorgias OAuth app only if your organization must use its own client credentials. This requires a [Gorgias Partner Portal](https://partners.gorgias.com/login) account, which is separate from your Gorgias helpdesk login. |
| 26 | |
| 27 | ### Create the Gorgias app |
| 28 | |
| 29 | 1. In the Partner Portal, click **Create New App**. |
| 30 | |
| 31 |  |
| 32 | 2. Enter an app name (such as `Composio Integration`), an app tagline, an app icon (required), and your app URL. |
| 33 | 3. In **Redirect URLs**, paste `https://backend.composio.dev/api/v1/auth-apps/add`. It must exactly match the `oauth_redirect_uri` field in your Composio auth config. |
| 34 | |
| 35 |  |
| 36 | 4. Select the OAuth scopes your integration needs, then click **Create**. |
| 37 | 5. Open the app in the Partner Portal and copy the **Client ID** and **Client Secret**. |
| 38 | |
| 39 |  |
| 40 | |
| 41 | ### Create the auth config in Composio |
| 42 | |
| 43 | 1. In the Composio dashboard, go to **Auth Configs**, click **Create Auth Config**, and select **Gorgias**. |
| 44 | 2. Set the authentication type to **OAuth2** and choose **Use your own developer authentication**. |
| 45 | 3. Paste the **Client ID** and **Client Secret**, enter the same scopes you selected in the Gorgias app, then click **Create Gorgias Auth Config**. |
| 46 | 4. Click **Connect Account**, enter your Gorgias subdomain (`acme` for `acme.gorgias.com`), authorize, and confirm the account shows as **Active**. |
| 47 | |
| 48 | See [Custom auth configs](/docs/auth-configuration/custom-auth-configs) for the general flow. |
| 49 | |
| 50 | ### Scopes |
| 51 | |
| 52 | The default auth config requests read and write scopes for account, users, customers, tickets, custom fields, events, integrations, jobs, macros, rules, satisfaction surveys, tags, and apps, plus `statistics:read`, `openid`, `email`, `profile`, and `offline`. Keep the scopes in the Gorgias app and the auth config the same, and request only what your integration uses. |
| 53 | |
| 54 | ### API base URL |
| 55 | |
| 56 | Composio sends Gorgias API calls to `https://{subdomain}.gorgias.com/api/`, using the subdomain you enter when you connect. |