GuidesRecipesAPI ReferenceChangelog
API Reference

Time Off Approval Webhooks

❗️

Limited Support

Paylocity Webhooks support time off approvals only through HR & Payroll. Time & Labor Time Off Approvals are not supported.

Webhooks are not supported for cancellations or changes to time off requests.

Triggers for Time Off Approval Webhooks Notification

  • Supervisor or Manager approval of time off requests

Common use cases for these Webhooks

  1. Sync up changes across the systems.
  2. Sync up a calendar storing the time off schedules for employees.

Message Syntax

The message header includes the following:

KeyValue
connectionclose
expect100-continue
content-length<sum of characters/rows on the json body>
host<specific to connection>
content-typeapplication/json
PropertyTypeDescriptionSample
{
companyIdstringThe employee's assigned company id."companyId": "C01",
employeeCostCenter1stringThe employee's first assigned cost center."employeeCostCenter1": "11",
employeeCostCenter2stringThe employee's second assigned cost center."employeeCostCenter2": "22",
employeeCostCenter3stringThe employee's third assigned cost center."employeeCostCenter3": "33",
employeeIdstringThe employee's unique identifier."employeeId": "12345",
employeeNamestringThe employee’s Name."employeeName": "Jane Doe",
hoursPerDaystringThe number of hours for the time off request."hoursPerDay": "8",
isAllDayEventstringThe request is for all day. True or false."isAllDayEvent": "false",
employeeWorkEmailstringThe employee's Work Email address."employeeWorkEMailAddress": "jdoe @work.com",
supervisorWorkEmailstringThe supervisor's Work Email address."supervisorWorkEmail": "lsmith @work.com",
timeOffStartDatedate-timeThe start date of the time off request."timeOffStartDate": "2017-02-16T08:00:00-06:00 ",
timeOffEndDatedate-timeThe end date of the time off request."timeOffEndDate": "2017-02-16T16:00:00-06:00",
}

Code Example

{
  "companyId": "C01",
  "employeeCostCenter1": "11",
  "employeeCostCenter2": "22",
  "employeeCostCenter3": "33",
  "employeeId": "12345",
  "employeeName": "Jane Doe",
  "hoursPerDay": "8",
  "isAllDayEvent": "false",
  "employeeWorkEMailAddress": "[email protected]",
  "supervisorWorkEmail": "[email protected]",
  "timeOffStartDate": "2017-02-16T08:00:00-06:00 ",
  "timeOffEndDate": "2017-02-16T16:00:00-06:00",
}

📘

Additional Information

  • Paylocity reserves the right to impose rate limits on the number of calls made to Paylocity APIs. If rate limits are present, a 429 response code, Too Many Requests, returns from the API.
  • Paylocity no longer supports an out-of-the-box solution for Office 365 and PTO requests using Power Automate.

Copyright © 2024 Paylocity. All Rights Reserved. Privacy Center | Terms and Conditions | Accessibility