Time Doctor and Vacation Tracker Integration
Note: Vacation Tracker Integration is available for purchase across all Time Doctor subscription plans and is accessible to users with Owner and Admin access.
This integration is available only to interactive users.
TL;DR:
- Connect Vacation Tracker via Settings > Integrations > Native tab
- Configure filters and enable User Sync and/or Time Off Sync
- Sync runs every 12 hours
- Data flows one-way from Vacation Tracker to Time Doctor
- Matching is based on email addresses
Connect Vacation Tracker with Time Doctor to automatically sync Users and Time Off records. Eliminate manual updates and maintain accurate workforce data.
Enable the integration to:
- Automatically add and manage Users
- Sync approved Time Off requests
Note: This is a one-way sync. Data flows from Vacation Tracker to Time Doctor only.
Available Sync Options
Enable one or both sync types:
Before Getting Started
Ensure the following:
- Vacation Tracker is used to manage HR data and Time Off
- Time Doctor is used for time tracking
- Employee email addresses match in both systems
- Only active and fully onboarded employees are included
- Admin access is available in both platforms
How to Set Up the Integration
- Go to Settings > Integrations > Native tab
- Locate Vacation Tracker Integration
- Purchase the Integration and click Connect
- Enter the Vacation Tracker API Key when prompted
How to Generate Your API Key if you have administrator access to Vacation Tracker:- Log in to your dashboard account.
- Navigate to the Add-Ons section.
- Find the Open API card under the "Discover more add-ons" tab and complete the activation/purchase.
- Go to My Add-Ons and click View on the Open API card.
- Enter a name for your key and click Create new API key. [watch the video]

- Configure Filters before enabling User Sync and/or Time Off Sync

- Click Save
- Enable User Sync and/or Time Off Sync
Part 1: User Sync
Overview
Keep the workforce directory up to date automatically. Sync Users based on their status in Vacation Tracker.
How It Works
- Sync runs every 12 hours
- Changes in Vacation Tracker trigger updates in Time Doctor
- Actions include adding, archiving, or reactivating Users
|
Employee Status in Vacation Tracker |
What Happens in Time Doctor |
|
Active / Employed |
Employee is created in Time Doctor |
|
Inactive / Terminated |
Employee is archived in Time Doctor |
Filter Synced Users
Limit sync scope during setup:
- Sync all Departments
- Sync selected Departments
If no Users exist in Time Doctor:
- Select Department(s)
- Click Save
- Click Sync Now to import existing Users
To sync only newly added Users:
- Select Department(s)
- Click Save
- Close setup without running Sync Now

Important Notes
- Users are matched by email address
- Select Departments to control sync scope
- Existing Users are not duplicated during full sync
- New Users in Vacation Tracker are automatically added
- Newly created Departments must be manually selected to be included in the sync
- Email updates in Vacation Tracker must be updated manually in Time Doctor
- User name changes in Vacation Tracker sync automatically to Time Doctor
Note: New Users created via integration are set as billable Users by default.
Part 2: Time Off Sync
Overview
Automatically sync approved Time Off requests from Vacation Tracker into Time Doctor.
How It Works
- Sync future approved Time Off after activation
- Sync updates every 12 hours
- Contact support to sync historical records
Important: Only approved requests are synced.
Time Off Mapping
Supported Time Off types from Vacation Tracker:
|
Time Off Type in Vacation Tracker |
How It Appears in Time Doctor |
|
Full-day Time Off |
Mapped as a full 8-hour absence (9:00 AM to 5:00 PM) in your Time Doctor company's timezone |
|
Time-based Time Off (e.g., 9 AM – 2 PM) |
Mapped to the exact start and end times specified |
|
Partial-day Time Off (e.g., half day) |
Hours are mapped starting from 9:00 AM, based on a standard 9:00 AM – 5:00 PM schedule |
Duplicate Time Off Handling
Configure how duplicate time off records are handled:
|
Option |
What It Does |
Best For |
|
Skip (Recommended) |
Keeps the existing Time Doctor Time Off and ignores the incoming Vacation Tracker entry. |
When Time Doctor is your source of truth for Time Off requests |
|
Replace |
Deletes the existing Time Doctor Time Off and replaces it with the Vacation Tracker data. |
When Vacation Tracker should always take priority |
|
Merge |
Adds the Vacation Tracker Time Off alongside the existing entry. Identical time slots are deduplicated automatically. |
When employees may have Time Off from multiple sources |
Important:
- Custom leave type mapping is not supported
- Default mapping uses paid/unpaid categories
- Updates to synced records reflect in Time Doctor
- Do not submit Time Off directly in Time Doctor when integration is active

Part 3: Sync Departments structure
Overview
Mirror your Vacation Tracker department structure in Time Doctor automatically. When enabled, Time Doctor Groups are created based on HRIS department names, and users are assigned to the matching Group.
How It Works
- Time Doctor Groups are created using the department names from Vacation Tracker
- New users synced from Vacation Tracker are automatically assigned to the Group that matches their HRIS department
- Existing users are reassigned to the correct Group if their department changes in Vacation Tracker
- Sync runs every 12 hours alongside User Sync
Important Notes
- Group names in Time Doctor are derived from the Vacation Tracker department name — changes to the department name in Vacation Tracker will create a new Group in Time Doctor
- Users with no department assigned in Vacation Tracker will not be assigned to any Group
- Manually created Groups in Time Doctor are not affected

Day-to-Day Usage
- Submit and approve Time Off in Vacation Tracker
- Updates appear in Time Doctor within 12 hours
- Manage employee status changes in Vacation Tracker
Sync History
Navigate to the History tab to review your sync history:
INSERT SCREENSHOT HERE
Disabling the Integration
- Turn off Sync Users and/or Sync Time Off to pause syncing
- Click Remove from Account to fully remove integration from your account and stop future billing
Important: Existing data remains in Time Doctor.
Troubleshooting
Users Not Syncing
- Confirm the employee is active and onboarded
- Verify matching email addresses
- Allow up to 12 hours for sync
Time Off Not Syncing
- Ensure the request is approved
- Confirm supported date range
- Verify email match
Time Off Not Overwriting
- Check the Duplicate Time Off Handling setting
Incorrect Time Off Hours
- Verify start/end times in Vacation Tracker
- Default time is 9:00 AM – 5:00 PM
- Adjust fractional hours manually if needed
Should there be any inconsistencies or concerns regarding the article, contact support@timedoctor.com for prompt assistance.