Other advanced guides
Whitelabel the OAuth flow
Step-by-step guide on whitelabeling the OAuth flow by using a custom callback URL.
Complete the following steps to whitelabel the OAuth flow:
Use your own OAuth app
You can use your own OAuth app to handle the OAuth flow as described in the Configure an integration guide. This way, the OAuth flow to match your brand and user experience.
Use a custom callback URL
Some API providers (e.g. Google) show the domain of the callback URL to the user during the OAuth flow. By default, the domain of the callback URL is api.nango.dev
.
You can whitelabel this experience by using a custom callback URL which uses your domain.
If you are using Nango Cloud, follow these steps:
- Add a new endpoint in your app, e.g.
https://EXAMPLE.com/oauth-callback
. All requests to this endpoint should redirect tohttps://api.nango.dev/oauth/callback
and pass along all original parameters. The easiest way to do this is with a 308 redirect. - Change the registered OAuth callback URL with all API providers. Otherwise, they will refuse new flows!
- When ready, change your Nango callback URL in the Environment Settings tab.
If you are self-hosting Nango, follow the instructions here to change your callback URL.
Was this page helpful?