BitBucket

Version control repository hosting service

Go to site
Explore
/
Apps
/
BitBucket

BitBucket API Integrations

Build and run workflows using the BitBucket API. Use 1000s of open source triggers and actions across 800+ apps. Or write custom code to integrate any app or API in seconds.

import { axios } from "@pipedream/platform"
export default defineComponent({
  props: {
    bitbucket: {
      type: "app",
      app: "bitbucket",
    }
  },
  async run({steps, $}) {
    return await axios($, {
      url: `https://api.bitbucket.org/2.0/user`,
      headers: {
        Authorization: `Bearer ${this.bitbucket.$auth.oauth_access_token}`,
      },
    })
  },
})

Authentication

BitBucket uses OAuth authentication. When you connect your BitBucket account, Pipedream will open a popup window where you can sign into BitBucket and grant Pipedream permission to connect to your account. Pipedream securely stores and automatically refreshes the OAuth tokens so you can easily authenticate any BitBucket API.

Pipedream requests the following authorization scopes when you connect your account:

accountaccount:writeteam:writerepository:writepullrequest:writesnippet:writeissue:writeemailwikiwebhook
OAuth Request Configurations:
  1. authorization
    GEThttps://bitbucket.org/site/oauth2/authorize?client_id={{oauth.client_id}}&state={{oauth.state}}&redirect_uri={{oauth.redirect_uri}}&response_type=code&scope={{oauth.space_separated_scopes}}
  2. accessToken
    POSThttps://bitbucket.org/site/oauth2/access_tokencontent-type: application/x-www-form-urlencodedaccept: application/json
    client_id={{oauth.client_id}}&client_secret={{oauth.client_secret}}&grant_type=authorization_code&code={{oauth.code}}&redirect_uri={{oauth.redirect_uri}}
  3. refreshToken
    POSThttps://bitbucket.org/site/oauth2/access_tokencontent-type: application/x-www-form-urlencodedaccept: application/json
    client_id={{oauth.client_id}}&client_secret={{oauth.client_secret}}&grant_type=refresh_token&refresh_token={{oauth.refresh_token}}