{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-agen-for-work/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["Notification","LightboxImage"]},"type":"markdown"},"seo":{"title":"Bitbucket integration","siteUrl":"https://developers.frontegg.com/","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"bitbucket-integration","__idx":0},"children":["Bitbucket integration"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Bitbucket is a Git-based code hosting and collaboration platform built for teams. Integrating Bitbucket with Frontegg allows your application to access repositories, pull requests, and issues on behalf of your users through OAuth 2.0 authentication."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Notification","attributes":{"title":"Prerequisites","type":"attention"},"children":[{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["A Bitbucket account with access to a workspace"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Admin access to the Bitbucket workspace settings"]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"connect-bitbucket","__idx":1},"children":["Connect Bitbucket"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"step-1-open-the-oauth-consumers-settings","__idx":2},"children":["Step 1: Open the OAuth consumers settings"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Log in to ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://bitbucket.org"},"children":["Bitbucket"]}," and navigate to your workspace. Click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Settings"]}," in the left sidebar, then expand ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Apps and features"]}," and click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["OAuth consumers"]},". Click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Add consumer"]}," to create a new OAuth application."]},{"$$mdtype":"Tag","name":"LightboxImage","attributes":{"isLightbox":true},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/bitbucket-1.9b1d6e435b410ded10650ff48cdea35e885d46589488b7307fbdad83a3c6be35.1ce25488.png","alt":"Bitbucket OAuth consumers"},"children":[]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"step-2-fill-in-the-application-details","__idx":3},"children":["Step 2: Fill in the application details"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Add OAuth consumer"]}," form, fill in the following fields:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Name"]}," — Enter a descriptive name (e.g., \"Frontegg Integration\")"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Callback URL"]}," — Enter the Frontegg redirect URI:"," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["https://YOUR_MCP_GATEWAY_URL/integration-callback"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["URL"]}," — Enter your application homepage URL"]}]},{"$$mdtype":"Tag","name":"LightboxImage","attributes":{"isLightbox":true},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/bitbucket-2.ce0de54c78a469be252f8107ea00e463bc99c2808d7e5f38c8f25754564019ee.1ce25488.png","alt":"Bitbucket application details form"},"children":[]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"step-3-configure-permissions","__idx":4},"children":["Step 3: Configure permissions"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Scroll down to the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Permissions"]}," section and select the scopes your application requires:"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Scope"},"children":["Scope"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["account"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Read account information"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["repository"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Read repositories"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["repository:write"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Write to repositories"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["pullrequest"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Read and write pull requests"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["issue"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Read and write issues"]}]}]}]}]},{"$$mdtype":"Tag","name":"Notification","attributes":{"title":"Minimum required scopes","type":"info"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For basic functionality, select ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["account"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["repository"]},". Add ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["pullrequest"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["issue"]}," if your application needs to work with pull requests or issues."]}]},{"$$mdtype":"Tag","name":"LightboxImage","attributes":{"isLightbox":true},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/bitbucket-3.e343ca23096942b8a26b067c2ec4adb613329843f790a11779b0b33c81d4b529.1ce25488.png","alt":"Bitbucket permissions configuration"},"children":[]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"step-4-save-the-consumer","__idx":5},"children":["Step 4: Save the consumer"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Save"]}," at the bottom of the form to create your OAuth consumer."]},{"$$mdtype":"Tag","name":"LightboxImage","attributes":{"isLightbox":true},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/bitbucket-4.0c073d4caa257226d5620c12580fae1572fb2a03fd30146f167e9bdf7fc05736.1ce25488.png","alt":"Bitbucket save button"},"children":[]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"step-5-confirm-creation","__idx":6},"children":["Step 5: Confirm creation"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["After saving, you are redirected back to the OAuth consumers list. A confirmation message appears and your new consumer is listed in the table."]},{"$$mdtype":"Tag","name":"LightboxImage","attributes":{"isLightbox":true},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/bitbucket-5.d96d82ddbaeb7e97462333395254a1f57fcabb90988332403a747ec9bda48e4b.1ce25488.png","alt":"Bitbucket consumer created"},"children":[]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"step-6-copy-credentials","__idx":7},"children":["Step 6: Copy credentials"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Click on the name of your consumer in the list to expand its details. Copy the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Key"]}," (Client ID) and ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Secret"]}," (Client Secret) values — you will need them to configure the integration in the Frontegg portal."]},{"$$mdtype":"Tag","name":"Notification","attributes":{"title":"Keep your credentials secure","type":"attention"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Never share or commit your Client Secret to version control."]}]},{"$$mdtype":"Tag","name":"LightboxImage","attributes":{"isLightbox":true},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/bitbucket-6.f66bfb1e4094605ac6d66be4660ea335ea51c9adc76d20aea8ae47fc0196a4d4.1ce25488.png","alt":"Bitbucket credentials"},"children":[]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"step-7-find-your-workspace-slug","__idx":8},"children":["Step 7: Find your workspace slug"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In addition to the OAuth credentials, you need your Bitbucket ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["workspace slug"]},". Click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Settings"]}," in the left sidebar of your workspace, then open ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Workspace settings"]},". The ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Workspace ID"]}," field displays your workspace slug — copy this value."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You can also find the slug directly in any of your workspace URLs. For example, in ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["https://bitbucket.org/my-team/"]},", the workspace slug is ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["my-team"]},"."]},{"$$mdtype":"Tag","name":"LightboxImage","attributes":{"isLightbox":true},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/bitbucket-7.940a9ed552f8fcb70a0f587601754d48f22b331c879012f2466e940134aca193.1ce25488.png","alt":"Bitbucket workspace ID"},"children":[]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"configure-the-frontegg-portal","__idx":9},"children":["Configure the Frontegg portal"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Once you have obtained your ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Key"]}," (Client ID), ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Secret"]}," (Client Secret), and ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["workspace slug"]}," from the steps above, enter them in the integration configuration page of the Frontegg portal:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Open the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Frontegg portal"]}," and navigate to [ENVIRONMENT] → Integrations → Bitbucket."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Enter the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Key"]}," as the Client ID and ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Secret"]}," as the Client Secret in the corresponding fields."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Enter your Bitbucket workspace slug in the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Bitbucket workspace slug"]}," field (for example, ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["my-team"]},")."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Select the required ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["scopes"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Save"]},"."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"additional-resources","__idx":10},"children":["Additional resources"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://developer.atlassian.com/cloud/bitbucket/"},"children":["Bitbucket developer documentation"]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://developer.atlassian.com/cloud/bitbucket/rest/intro/#authentication"},"children":["Bitbucket OAuth 2.0 guide"]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://developer.atlassian.com/cloud/bitbucket/rest/"},"children":["Bitbucket REST API reference"]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/agen-for-work/connectors/redirect-url"},"children":["How to get your Redirect URL"]}]}]}]}]},"headings":[{"value":"Bitbucket integration","id":"bitbucket-integration","depth":2},{"value":"Connect Bitbucket","id":"connect-bitbucket","depth":3},{"value":"Step 1: Open the OAuth consumers settings","id":"step-1-open-the-oauth-consumers-settings","depth":4},{"value":"Step 2: Fill in the application details","id":"step-2-fill-in-the-application-details","depth":4},{"value":"Step 3: Configure permissions","id":"step-3-configure-permissions","depth":4},{"value":"Step 4: Save the consumer","id":"step-4-save-the-consumer","depth":4},{"value":"Step 5: Confirm creation","id":"step-5-confirm-creation","depth":4},{"value":"Step 6: Copy credentials","id":"step-6-copy-credentials","depth":4},{"value":"Step 7: Find your workspace slug","id":"step-7-find-your-workspace-slug","depth":4},{"value":"Configure the Frontegg portal","id":"configure-the-frontegg-portal","depth":3},{"value":"Additional resources","id":"additional-resources","depth":3}],"frontmatter":{"seo":{"title":"Bitbucket integration"}},"lastModified":"2026-05-01T18:45:25.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/agen-for-work/connectors/marketplace/bitbucket","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}