Setting Up Bitbucket Webhooks

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

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 Settings.

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

Paste Webhook URL

Enter the webhook URL you copied in step 1.

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

Add Webhook Secret

Create and configure a secret for secure webhook verification.

Please sign in to create a webhook secret.

Set Content Type

Configure the payload format for webhook requests.

Select the following content type:

application/json

Enable Push Events

Select which events should trigger the webhook.

Under Triggers, enable:

Repository push

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.

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 Settings → select your project → add the Bitbucket repository URL.

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

Add Secondary 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 secondary email to ensure your commits are tracked.

Setup Secondary Emails

Need more help? Check the official Bitbucket documentation.