# Connect a custom OAuth integration

> Bring your own OAuth app for branded consent, custom scopes, or services not in our catalog.

Custom OAuth lets you connect General Input to a service using your own OAuth app. Your branding on the consent screen, your scopes, and any provider that speaks OAuth 2.0.

<Callout type="note">
  This guide assumes you already have access to a provider's developer console
  (Google Cloud, Slack API, GitHub Developer Settings, etc.). If you don't, ask
  your IT team to help with the steps on the provider's side.
</Callout>

## When to use custom OAuth

- You want your company name and logo on the consent screen.
- You need scopes that aren't in our defaults.
- The service isn't in our 1-click catalog.

<Callout type="note">
  If none of these apply, use 1-click OAuth. Faster and we handle scope
  upgrades.
</Callout>

## Set it up

<Steps>
<Step>
Click your workspace name in the sidebar, choose **Settings**, and open **Custom OAuth** under the **Workspace** section.

<Screenshot
  src="/guides/custom-oauth/open-settings.mp4"
  caption="Opening Custom OAuth in workspace settings"
/>
</Step>
<Step>
Search for the integration you want to connect and open it.

<Screenshot
  src="/guides/custom-oauth/search-docusign.mp4"
  caption="Searching for an integration"
/>
</Step>
<Step>
Follow the in-app guide to create an OAuth app in the provider's developer console and grab the credentials.

<Screenshot
  src="/guides/custom-oauth/docusign-guide.mp4"
  caption="In-app provider setup guide"
/>
</Step>
<Step>
Paste the `client_id` and `client_secret` back into our dialog, review the scopes the connection will request, and save.

<Screenshot
  src="/guides/custom-oauth/docusign-connect.mp4"
  caption="Pasting OAuth credentials"
/>
</Step>
<Step>
Click **Connect** to authorize the first connection. Your branding shows on the provider's consent screen.

<Screenshot
  src="/guides/custom-oauth/connect-oauth.webp"
  caption="Branded OAuth consent screen"
/>
</Step>
</Steps>

<Callout type="note">
  There is also a **Custom OAuth** section under **Personal** settings for
  connections only you use. Workspace-level connections are shared with the
  whole team.
</Callout>