║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║

---

title: Add Bitbucket as a social connection description: Learn how to allow users to sign up and sign in to your Clerk app with their Bitbucket account with OAuth.

<TutorialHero beforeYouStart={[ { title: "A Clerk app is required.", link: "/docs/getting-started/quickstart/setup-clerk", icon: "clerk", }, { title: "A Bitbucket account is required.", link: "https://bitbucket.org/account/signup", icon: "user-circle", } ]} />

Enabling OAuth with Bitbucket allows your users to sign up and sign in to your Clerk application with their Bitbucket account.

Configure for your development instance

For development instances, Clerk uses preconfigured shared OAuth credentials and redirect URIs—no other configuration is needed.

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. Select Add connection.

Configure for your production instance

For production instances, you must provide custom credentials.

To make the setup process easier, it's recommended to keep two browser tabs open: one for the Clerk Dashboard and one for your Bitbucket Workspaces page.

<Steps> ### 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 sidenav, 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.

[!NOTE] If the modal or page is no longer open, navigate to the SSO connections page in the Clerk Dashboard. Select the connection. Under Use custom credentials, paste the values into their respective fields.

Test your connection

<Include src="_partials/authentication/social-connections/test-your-connection" /> </Steps>

║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║