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

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

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 GitHub documentation.

Setup GitHub Webhook | Clocktopus