Add GitHub as a social connection
How to set up social connection with GitHub
Overview
Adding social connection with GitHub to your app with Clerk is done in a few steps - you only need to set the Client ID, Client Secret and Authorized redirect URI in your instance settings.
To make the development flow as smooth as possible, Clerk uses preconfigured shared OAuth credentials and redirect URIs for development instances - no other configuration is needed.
For production instances, you will need to generate your own Client ID and Client secret using your GitHub account.
Before you start
- You need to create a Clerk Application in your Clerk Dashboard. For more information, check out our Set up your application guide.
- You need to have a GitHub account. To create one, click here.
Configuring GitHub social connection
First, you need to register a new OAuth GitHub app. Follow the official GitHub instructions on how to create an OAuth app.
Navigate to the Clerk Dashboard. In the top navigation, select Configure. Then in the sidebar, select SSO Connections. Select the Add connection button, and select For all users. In the Choose provider dropdown, select GitHub. Toggle on Use custom credentials and copy Authorized redirect URI. Go back to the GitHub panel, paste the value into the Authorization callback URL field and complete the registration.
Once registration is complete, you'll get redirected to project's admin panel. Click the Generate a new client secret button to get your new client secret. Then, copy the Client ID and Client secret. Go back to the Clerk Dashboard and paste them into the respective fields.
Finally, select Add connection so that the settings are applied. Congratulations! Social connection with GitHub is now configured for your instance.
Feedback
Last updated on