Add Bitbucket as a social connection

Enable Bitbucket 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 Bitbucket.
4. Ensure that both Enable for sign-up and sign-in and Use custom credentials are toggled on.
5. Save the Callback URL somewhere secure. Keep the modal and page open.

Create a Bitbucket OAuth Consumer

1. On a separate page, go to the Bitbucket Workspaces⁠ page and sign in.
2. Under Workspaces, find your workspace and select Manage.
3. In the sidebar, scroll down and select OAuth consumers.
4. Select Add consumer.
5. Complete the required fields. In Permissions , under Account, select Email and Read.
6. Select Save. You'll be redirected to the OAuth consumers page.
7. Select your consumer and save the Key and Secret values somewhere secure.

Set the Key and Secret in the Clerk Dashboard

1. Navigate back to the Clerk Dashboard where the modal should still be open. Paste the Key and Secret values that you saved into the respective fields.
2. Select Add connection.

Test your connection

The simplest way to test your connection 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 connection's credentials.