--- updatedAt: 2026-09-30T20:13:40.000Z agentTools: projectIndex: https://docs.wristband.dev/llms.txt --- # GitHub ## Setting Up a GitHub Integration Learn how to set up GitHub social login in Wristband with this step-by-step guide. ### Step 1: Locate Your External IdP Callback URL * In the Wristband dashboard, enter **Application View** for the application you want to integrate with GitHub. * Navigate to the `Identity Providers > Social` menu in the side navigation. * After landing on the Social Identity Providers page, select the **GitHub **provider icon at the top. * Copy the **Redirect URL** from the form. ### Step 2: Sign Up/Login to Your GitHub Account Before configuring the GitHub Social Login Identity Provider in the Wristband dashboard, ensure you are logged into your GitHub account. ### Step 3: Register an OAuth Application 1. Click your profile icon in the navigation bar and select **Settings**. GitHub home page 2. From the left sidebar, select **Developer Settings**. GitHub settings page Navigate to **OAuth Apps** in the left sidebar and click the **Register a new application** button. 3. Complete the form by filling out the following required fields: * **Application Name**: Any appropriate value. * **Homepage URL**: Any appropriate value. * **Authorized callback URL**: Paste the External IdP Callback URL from step 1. * Click **Register application** to finish. ### Step 4: Create OAuth Credentials 1. Once registered, you will be directed to your app's **General Settings **page. **Copy the Client ID**, as you will need it for the next steps. 2. Click **Generate a new client secret** to create a client secret. Client ID in GitHub 3. **Copy the Client Secrets **value as it appears on the page**.** Client Secret in GitHub * You have now completed the required configuration on GitHub for your social login integration. ### Step 5: Configure the GitHub IdP in Wristband 1. Return to the **Social Identity Provider** page in the **Wristband dashboard** (from step 1) and enter the following values into the form: * ** Client ID**: The Client ID from step 4. * ** Client Secret**: The Client Secret from step 4. 2. Wristband requests the following scopes by default during GitHub authorization (any additional scopes are optional): * user:email 3. Click S**ave** to finish. The GitHub External IDP will be in an `ENABLED` status. The GitHub social login integration is now complete. Unless **Tenant Overrides** are enabled, users will see a GitHub login button the next time they visit the **Tenant-level Login** Page. GitHub login button on Tenant-level Login Page