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
- Sync up changes across the systems.
- Sync up a calendar storing the time off schedules for employees.
Message Syntax
The message header includes the following:
| Key | Value |
|---|---|
| connection | close |
| expect | 100-continue |
| content-length | <sum of characters/rows on the json body> |
| host | <specific to connection> |
| content-type | application/json |
| Property | Type | Description | Sample |
|---|---|---|---|
| { | |||
| companyId | string | The employee's assigned company id. | "companyId": "C01", |
| employeeCostCenter1 | string | The employee's first assigned cost center. | "employeeCostCenter1": "11", |
| employeeCostCenter2 | string | The employee's second assigned cost center. | "employeeCostCenter2": "22", |
| employeeCostCenter3 | string | The employee's third assigned cost center. | "employeeCostCenter3": "33", |
| employeeId | string | The employee's unique identifier. | "employeeId": "12345", |
| employeeName | string | The employee’s Name. | "employeeName": "Jane Doe", |
| hoursPerDay | string | The number of hours for the time off request. | "hoursPerDay": "8", |
| isAllDayEvent | string | The request is for all day. True or false. | "isAllDayEvent": "false", |
| employeeWorkEmail | string | The employee's Work Email address. | "employeeWorkEMailAddress": "jdoe @work.com", |
| supervisorWorkEmail | string | The supervisor's Work Email address. | "supervisorWorkEmail": "lsmith @work.com", |
| timeOffStartDate | date-time | The start date of the time off request. | "timeOffStartDate": "2017-02-16T08:00:00-06:00 ", |
| timeOffEndDate | date-time | The 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.