Setting Up Bitbucket Webhooks

Configure Bitbucket webhooks for automated time tracking. Set up at the repository or workspace level.

1

Get Your Webhook URL

Copy your unique webhook URL to use in Bitbucket.

Please sign in to get your webhook URL, or find it in the Git Webhook settings.

2

Open Bitbucket Settings

Navigate to webhook settings in your repository or workspace.

RepoRepository settings → Webhooks → Add webhook
WorkspaceWorkspace settings → Webhooks → Add webhook
View Bitbucket Docs
3

Paste Webhook URL

Enter the webhook URL you copied in step 1.

In the webhook form, paste your URL into the URL field.

4

Add Webhook Secret

Create and configure a secret for secure webhook verification.

Please sign in to create a webhook secret.

5

Set Content Type

Configure the payload format for webhook requests.

Select the following content type:

application/json
6

Enable Push Events

Select which events should trigger the webhook.

Under Triggers, enable:

Repository push
7

Save Webhook

Complete the setup by saving your configuration.

Click Save or Create webhook to finish.

Your webhook is now ready to track commits automatically.
8

Add Repository URL to Project

Link the repository to your project for commit tracking.

To track commits for this repository, add the repository URL to your project. Go to Projects settings → select your project → add the Bitbucket repository URL.

Commits will only be tracked for repositories configured in your project settings.
9

Add Tracked Emails (Optional)

Link commits from different email addresses to your account.

If the email in your git config differs from your Clocktopus login email, add it as a tracked email to ensure your commits are tracked.

Setup Tracked Emails

Need more help? Check the official Bitbucket documentation.