Bitbucket | Entitle

Create an app token

1. Go to the Atlassian API Tokens page and click Create API token with scopes.

2. Set your preferred name and expiration for the token, then click Next.

   

3. Choose Bitbucket as the API token app, then click Next.

   

4. Provide the token with these scopes, then click Next:

   admin:workspace:bitbucket
   admin:repository:bitbucket
   read:workspace:bitbucket
   read:repository:bitbucket
   read:permission:bitbucket
   write:permission:bitbucket
   delete:permission:bitbucket

5. Review your API token details. Once you have verified that everything is correct, click Create token.

   

6. Copy the token so you can provide it to the Entitle software when creating the integration.

   

7. Copy your email from the Atlassian Email page.

Jira credentials for email matching (optional)

Bitbucket does not provide user email addresses through its API. As a result, Entitle cannot automatically match Bitbucket users to identities based on email.

To enable email-based matching, configure Jira credentials. Entitle uses the Jira API to retrieve user email addresses for this purpose.

ℹ️

To create the API token for the key field, go to the Atlassian API Tokens page and click Create API token (not Create API token with scopes).

✅

Example JSON

{
  "email": "<EMAIL>",
  "app_token": "<APP_TOKEN>",
  "jira_credentials": {
    "url": "https://<YOUR_SUBDOMAIN>.atlassian.net",
    "key": "<API_TOKEN>",
    "user": "[email protected]"
}