Clockify Integration

Overview

The Clockify integration connects your time tracking data with Jasper's code review workflow. Track how much time your team spends on reviews, automatically link time entries to PRs, and generate reports on development effort.

Key Features

• Time Entry Sync — Automatically sync time entries from your Clockify workspace
• PR Auto-Linking — Link time entries to PRs based on description patterns
• User Mapping — Map Clockify users to GitHub contributors
• Project Mapping — Map Clockify projects to GitHub repositories
• Real-time Webhooks — Stay in sync with instant webhook updates
• Analytics Integration — View time data alongside review metrics

Connecting Clockify

Connect your Clockify workspace to Jasper using an API key.

Step 1: Generate API Key

1. Log in to Clockify
2. Click your profile icon → Profile Settings
3. Scroll to API section
4. Click Generate to create a new API key
5. Copy the generated key

Step 2: Connect in Jasper

1. Go to Settings → Integrations → Clockify
2. Click Enable Clockify Integration
3. Paste your API key
4. Select the workspace you want to connect
5. Click Connect

Once connected, Jasper will automatically:

• Fetch your workspace members for user mapping
• Import projects for repository mapping
• Register webhooks for real-time sync
• Perform an initial sync of recent time entries (last 30 days)

User Mapping

Map Clockify users to GitHub usernames to attribute time entries to the correct contributors.

Automatic Mapping

Jasper attempts to automatically match users based on:

• Email address — If the Clockify email matches a GitHub-linked account
• Name matching — If names are similar between platforms

Manual Mapping

For users that couldn't be auto-matched:

1. Go to Settings → Clockify → User Mapping
2. Find the unmapped Clockify user
3. Select the corresponding GitHub user from the dropdown
4. Click Save Mapping

Project Mapping

Link Clockify projects to GitHub repositories to automatically associate time entries with the correct repos.

Setting Up Mappings

1. Go to Settings → Clockify → Project Mapping
2. Select a Clockify project
3. Choose the corresponding GitHub repository
4. Optionally set a custom match pattern
5. Save the mapping

Automatic PR Linking

Jasper automatically links time entries to pull requests based on patterns in the entry description.

Supported Patterns

Include any of these in your Clockify time entry description to auto-link:

Pattern	Example
PR #123	"Working on PR #42 review"
PR-123	"PR-42 code cleanup"
Pull Request #123	"Pull Request #42 fixes"
#123	"Reviewing #42"
GitHub PR URL	"https://github.com/org/repo/pull/42"

Manual Linking

For entries without automatic matches, you can manually link them:

1. Open a review in Jasper
2. Go to the Time Tracking section
3. Click Link Time Entry
4. Search for the Clockify entry by description or date
5. Select the entry and confirm

Webhooks

Clockify webhooks keep your data synchronized in real-time.

Supported Events

Event	Description
TIME_ENTRY_CREATED	A new time entry was started or logged
TIME_ENTRY_UPDATED	A time entry was modified
TIME_ENTRY_DELETED	A time entry was removed
TIMER_STOPPED	An active timer was stopped
PROJECT_CREATED	A new project was added
PROJECT_UPDATED	Project details were changed
PROJECT_DELETED	A project was removed

Webhook Management

Manage webhook status in Settings → Clockify → Webhooks:

• View Status — Check if webhooks are properly registered
• Re-register — Fix broken webhook connections
• Regenerate Secret — Rotate the webhook validation secret
• View Logs — See incoming webhook deliveries

Sync Settings

Configure how Jasper syncs with Clockify:

Sync Frequency

Option	Description
Real-time	Via webhooks (recommended)
Hourly	Full sync every hour
Daily	Full sync once per day
Manual	Only sync when triggered

Sync Range

Configure how far back to sync time entries:

• Initial sync: Up to 365 days (default: 30 days)
• Incremental sync: Last 24 hours

Viewing Time Data

Once connected, time data appears throughout Jasper:

Review Pages

Each review shows linked time entries with:

• Total time spent on the PR
• Individual time entries with descriptions
• Who logged the time
• Billable vs non-billable breakdown

Analytics

The analytics dashboard includes time tracking metrics:

• Average time per PR
• Time by contributor
• Billable hours tracking
• Time trends over periods

Billing Information

Track billable hours and costs:

• Default hourly rate: Set at organization level
• Project rates: Override per Clockify project
• Currency: Configurable (default: AUD)
• Billable flag: Honors Clockify's billable setting per entry

Disconnecting

To disconnect the Clockify integration:

1. Go to Settings → Clockify
2. Click Disconnect
3. Confirm the action

This will:

• Unregister all webhooks
• Remove stored credentials
• Preserve existing time entry links (for historical data)

Troubleshooting

Time entries not syncing

• Check that webhooks are registered in Settings → Clockify → Webhooks
• Verify your API key is still valid in Clockify
• Try triggering a manual sync

Entries not linking to PRs

• Ensure the time entry description contains a valid PR pattern
• Check that user and project mappings are configured
• Verify the PR exists in a connected repository

API key rejected

• Regenerate your API key in Clockify settings
• Make sure you copied the full key without extra spaces
• Check that your Clockify account has workspace access