Triggers for Time Off Approval Webhooks Notification
- Supervisor or Manager approvals of time off requests trigger the notifications; webhooks are not supported for cancellations or changes to time off requests
Common use cases for these Webhooks
- Create a calendar of approved time off events 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": "GC3456789", |
| 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 | decimal | The number of hours for the time off request. | "hoursPerDay": 8.0, |
| isAllDayEvent | boolean | 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":"GC3456789",
"employeeId":"12345",
"employeeName":"Jane Doe",
"employeeWorkEMailAddress":"[email protected]",
"employeeCostCenter1":"11",
"employeeCostCenter2":"22",
"employeeCostCenter3":"33",
"supervisorWorkEmail":"[email protected]",
"timeOffStartDate":"2017-02-16T08:00:00-06:00 ",
"timeOffEndDate":"2017-02-16T16:00:00-06:00",
"isAllDayEvent":false,
"hoursPerDay":8.0
}
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.