Composio powers 1000+ toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.
How do I connect Gorgias with Composio-managed OAuth?
With managed OAuth you don't need your own Gorgias app or client credentials. The flow starts in Gorgias and finishes in Composio.
- In Gorgias, go to Settings > App Store > All Apps, search for Composio, open it, and click Authorize.

2. In the Composio dashboard, open your project's Toolkits page, search for Gorgias, and click Add to Project.
3. Name the auth config, click Next, choose OAuth 2.0 > Composio Managed, and click Create Gorgias Auth Config.

4. Open the auth config and click Connect Account. Enter your Gorgias subdomain: for acme.gorgias.com, enter acme.
5. Review the Gorgias permission screen, click Authorize, and confirm the account shows as Active in Composio.
How do I set up custom OAuth credentials for Gorgias?
Use your own Gorgias OAuth app only if your organization must use its own client credentials. This requires a Gorgias Partner Portal account, which is separate from your Gorgias helpdesk login.
Create the Gorgias app
- In the Partner Portal, click Create New App.
2. Enter an app name (such as Composio Integration), an app tagline, an app icon (required), and your app URL.
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.
4. Select the OAuth scopes your integration needs, then click Create.
5. Open the app in the Partner Portal and copy the Client ID and Client Secret.

Create the auth config in Composio
- In the Composio dashboard, go to Auth Configs, click Create Auth Config, and select Gorgias.
- Set the authentication type to OAuth2 and choose Use your own developer authentication.
- Paste the Client ID and Client Secret, enter the same scopes you selected in the Gorgias app, then click Create Gorgias Auth Config.
- Click Connect Account, enter your Gorgias subdomain (
acmeforacme.gorgias.com), authorize, and confirm the account shows as Active.
See Custom auth configs for the general flow.
Scopes
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.
API base URL
Composio sends Gorgias API calls to https://{subdomain}.gorgias.com/api/, using the subdomain you enter when you connect.