> ## Documentation Index
> Fetch the complete documentation index at: https://docs.usehandled.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Using Your Own OAuth Credentials

> Replace Handled's OAuth app with your own for a branded experience

## Why Override OAuth?

* Your app name appears during authorization (not "Handled")
* Control the scopes requested
* Use your own redirect URLs
* Manage credentials independently

## Prerequisites

1. Install the integration from the catalog
2. Create an OAuth app with the external service
3. Note your Client ID, Client Secret, and allowed scopes

## Setup Steps

<Steps>
  <Step title="Open Integration Settings">
    Go to **Integrations > Installed** and select your integration
  </Step>

  <Step title="Access Settings">
    Click **Settings**
  </Step>

  <Step title="Enable Override">
    Enable **Use your own OAuth credentials**
  </Step>

  <Step title="Enter Details">
    Enter:

    * **Redirect URL** - Add this to your OAuth app's allowed redirects
    * **Client ID** - From your OAuth app
    * **Client Secret** - From your OAuth app
    * **Scopes** - Permissions to request (check the service's API docs)
  </Step>

  <Step title="Save">
    Click **Save**
  </Step>
</Steps>

## Result

When customers connect accounts:

* They see your OAuth app requesting permission
* Authorization uses your credentials
* Access tokens are managed through your app

<Note>
  The redirect URL shown in Handled must be added to your OAuth app's allowed redirect URLs in the external service's developer settings.
</Note>