Skip to content
English
  • There are no suggestions because the search field is empty.

Time Doctor and PeopleForce Integration

Note: PeopleForce Integration is available for purchase across all Time Doctor subscription plans and is accessible to users with Admin access.
This integration is available only to interactive users

TL;DR

  • Connect PeopleForce 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 PeopleForce to Time Doctor
  • Matching is based on email addresses


Connect PeopleForce 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 PeopleForce to Time Doctor only.

 

Available Sync Options

Enable one or both sync types:

 

Before Getting Started

Ensure the following:

  • PeopleForce 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

  1. Go to Settings > Integrations > Native tab
  2. Locate PeopleForce Integration
  3. Purchase the Integration and click Connect 
  4. Enter the PeopleForce API Key when prompted
  5. Configure Filters before enabling User Sync and/or Time Off Sync
  6. Click Save
  7. 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 PeopleForce.

 

How It Works

  • Sync runs every 12 hours
  • Changes in PeopleForce trigger updates in Time Doctor
  • Actions include adding, archiving, or reactivating Users

Employee Status in PeopleForce

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 PeopleForce are automatically added
  • Newly created Departments must be manually selected to be included in the sync
  • Email updates in PeopleForce must be updated manually in Time Doctor
  • User name changes in PeopleForce 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 PeopleForce 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 PeopleForce:

Time Off Type in PeopleForce

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 PeopleForce 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 PeopleForce data.

When PeopleForce should always take priority

Merge

Adds the PeopleForce 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

Day-to-Day Usage

  • Submit and approve Time Off in PeopleForce
  • Updates appear in Time Doctor within 12 hours
  • Manage employee status changes in PeopleForce

 

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 PeopleForce
  • 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.