Setting Up GitHub Webhooks

Configure GitHub webhooks for automated time tracking. Set up at the repository or organization level.

1

Get Your Webhook URL

Copy your unique webhook URL to use in GitHub.

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

2

Open GitHub Settings

Navigate to webhook settings in your repository or organisation.

RepoSettings → Webhooks → Add webhook
OrgSettings → Webhooks → Add webhook
View GitHub Docs
3

Paste Payload URL

Enter the webhook URL you copied in step 1.

In the webhook form, paste your URL into the Payload 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

Select Push Events

Choose which events should trigger the webhook.

Under Which events would you like to trigger this webhook?

Let me select individual events
Pushes
7

Save Webhook

Complete the setup by saving your configuration.

Ensure Active is checked, then click Add webhook.

GitHub will send a ping event to verify your webhook is configured correctly.
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 GitHub 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 GitHub documentation.