Bitbucket Cloud Setup

Connect SiftPulse to your Bitbucket workspace to get automated AI PR reviews on every pull request — the same review quality as GitHub, now for Atlassian-hosted teams.

What you'll get: SiftPulse posts a structured code review comment within 60 seconds of every PR opened or updated. Re-reviews on push edit the comment in place — no comment spam.

Step 1 — Create a Bitbucket OAuth Consumer

Open your workspace settings

In Bitbucket Cloud, navigate to Workspace settings → Apps and features → OAuth consumers.
URL pattern: https://bitbucket.org/<workspace>/workspace/settings/api

Add a new consumer

Click Add consumer and fill in:

Name: SiftPulse
Callback URL: https://siftpulse.polsia.app/integrations/bitbucket/callback
This is a private consumer — check this box

Grant the required scopes

Check exactly these permissions:

Scope	Why SiftPulse needs it
repository:read	Read PR diffs and file contents
pullrequest:write	Post and edit review comments on PRs
webhook	Register webhooks to receive PR open/update events
account	Read workspace and user email for dashboard login

Save and copy your credentials

After saving, Bitbucket shows you a Key (Client ID) and Secret (Client Secret). Copy both — you'll need them in the next step.

Step 2 — Add credentials to SiftPulse

The following environment variables must be set in your Render service (or wherever SiftPulse is deployed):

Environment variable	Value
BITBUCKET_CLIENT_ID	Key from the OAuth consumer you created
BITBUCKET_CLIENT_SECRET	Secret from the OAuth consumer
BITBUCKET_WEBHOOK_SECRET	Any long random string — used to verify webhook signatures

On Render: go to your service → Environment → add each variable → Save changes. Render will redeploy automatically.

Step 3 — Connect your workspace

Once the env vars are deployed, click the button below (or find it on your dashboard) to start the OAuth flow:

Connect Bitbucket workspace →

You'll be redirected to Bitbucket to grant the permissions you configured above. After authorizing, SiftPulse will store your workspace credentials and begin watching for new PRs.

Step 4 — Register webhooks on your repos

SiftPulse watches for pullrequest:created and pullrequest:updated events. Webhooks can be registered automatically on new repos, or you can add them manually:

Go to your repository settings

Navigate to Repository settings → Webhooks → Add webhook

Configure the webhook

Title: SiftPulse
URL:

https://siftpulse.polsia.app/webhooks/bitbucket

Secret: the value you set for BITBUCKET_WEBHOOK_SECRET
Triggers: check Pull Request → Created and Pull Request → Updated

How it works

When a PR is opened, SiftPulse fetches the diff via Bitbucket's API and runs the same AI review agent used for GitHub.
The review is posted as a PR comment within ~60 seconds.
When the PR is updated (new commits pushed), SiftPulse edits the existing comment in place — no duplicate comments.
Review events appear in your SiftPulse dashboard with provider: bitbucket in the activity feed.

Troubleshooting

OAuth flow returns an error — check that BITBUCKET_CLIENT_ID and BITBUCKET_CLIENT_SECRET are set correctly and that the callback URL exactly matches https://siftpulse.polsia.app/integrations/bitbucket/callback.

No review comment appears — verify the webhook is registered on the repo with the correct URL and triggers. Check that BITBUCKET_WEBHOOK_SECRET matches the secret you entered in Bitbucket. Logs are available in your Render dashboard.

Token expired errors — SiftPulse automatically refreshes tokens before they expire. If you see repeated auth failures, disconnect and reconnect via the dashboard.