Add GitLab as a social connection

Enable GitLab as a social connection in Clerk

1. In the Clerk Dashboard, navigate to the SSO Connections page.
2. Select Add connection and select For all users.
3. In the Choose provider dropdown, select GitLab.
4. Ensure that both Enable for sign-up and sign-in and Use custom credentials are toggled on.
5. Save the Redirect URI somewhere secure. Keep the modal and page open.

Create a GitLab app

1. In Gitlab, navigate to the Applications page.
2. Select Add new application.
3. Enter your app name in Name.
4. In Redirect URI, paste the Redirect URI you saved from the Clerk Dashboard.
5. Select the Scopes needed for your app. To allow users to sign up and sign in with GitLab, you must at least select read_user.
6. Select Save application. You'll be redirected to your app's settings page. Save the Application ID and Secret somewhere secure.

Set the Client ID and Client Secret in your Clerk Dashboard

1. Navigate back to your Clerk Dashboard where the modal should still be open. Paste the Application ID and Secret values in the Client ID and Client Secret fields, respectively.
2. Select Add connection.

Test your OAuth

The simplest way to test your OAuth is to visit your Clerk app's Account Portal, which is available for all Clerk apps out-of-the-box.

1. In the Clerk Dashboard, navigate to the Account Portal page.
2. Next to the Sign-in URL, select Visit. The URL should resemble:

• For development – https://your-domain.accounts.dev/sign-in
• For production – https://accounts.your-domain.com/sign-in

1. Sign in with your GitLab account.