Custom ConnectionsOAuth

OAuth

Learn how Giga uses OAuth to connect accounts without asking you to place provider secrets in Chat.

OAuth lets Giga connect to a service through an authorization flow where you approve access to an account.

It is a good fit when the provider supports delegated access and Giga can use a compatible OAuth flow for that service.

When OAuth is a good fit

Use OAuth when:

  • the service supports OAuth
  • you want to authorize Giga without manually sharing your account password
  • the provider supports the scopes Giga needs for the requested work
  • the integration already has an OAuth method available in Giga

For a new custom integration, Giga prefers OAuth after MCP when a supported self-serve OAuth flow is available.

How OAuth works

Choose the service

Start from Chat or the Connections area and tell Giga what you want to connect.

Open the authorization flow

Giga sends you through the provider’s secure sign-in and authorization experience.

Approve the requested access

Review the permissions requested by the provider and approve the access you want to grant.

Return to Giga

Once authorized, Giga can use the Connection within the permissions granted by both Giga and the provider.

Self-serve OAuth and DCR

For custom integrations, Giga can use OAuth directly when the provider supports a compatible self-serve setup.

One supported pattern is Dynamic Client Registration (DCR), where the OAuth client can be established through the provider’s supported flow rather than requiring someone to manually provision and pass around a shared client secret.

The live provider configuration decides the path

Giga should inspect the service’s actual OAuth capabilities before claiming that a custom OAuth connection can be completed automatically.

Your own OAuth app

Some organizations may need to connect using their own OAuth application.

When Giga supports that path, use the dedicated Custom OAuth setup page.

Do not paste a client secret, OAuth secret, or other sensitive credential into Chat.

Keep OAuth credentials in the secure setup flow

Client secrets and OAuth tokens belong in Giga’s secure connection layer, never in Chats, files, or Context Notes.

OAuth scopes matter

OAuth access is limited by the scopes and permissions granted during authorization.

That means a Connection may be able to read some data while being unable to perform certain write actions.

Giga should respect both:

  • the scopes granted through OAuth
  • the permissions of the connected account inside the provider

Sharing the Connection through Giga does not expand the provider-side permissions.

Built-in OAuth vs Custom OAuth

If the provider is already in Giga’s integration catalog, use the existing integration rather than creating another copy.

When OAuth is not self-serve

Some providers require a manually created OAuth client or other setup that Giga cannot establish automatically.

In that case, Giga should route you to the supported Custom OAuth setup rather than asking you to paste client credentials into Chat.

If a stronger supported option exists, such as MCP or an API key, Giga can use that instead according to the connection hierarchy.

OAuth and shared access

An OAuth-backed Connection can still participate in Giga’s sharing and permission model.

A user may be able to use a Connection shared through a Group without owning the underlying credential or being able to remove it.

The connected account’s provider permissions still apply.

Learn about Sharing Connections →

Example: connect a company SaaS account

Image placeholder

Flow showing Giga → provider OAuth authorization → approved scopes → Connection available in Giga.