---
updatedAt: 2026-03-24T18:51:13.000Z
agentTools:
  siteIndex: https://developer.paylocity.com/llms.txt
  projectIndex: https://developer.paylocity.com/integrations/llms.txt
---

# Employee Change Webhooks

# Triggers for Employee Change Webhooks Notification

Change employee data using one of the following processes:

* Log into HR & Payroll and make changes to employee data, such as modifying address fields, cost center, or status, or rehiring an employee.
* Modify employee data via Web Link imports.
* Use Paylocity Web Services API with an update employee request.

The following fields trigger the **Employee Change** Webhook:

| Fields                |                          |                             |
| :-------------------- | :----------------------- | :-------------------------- |
| LastName              | PersonalEmail            | Phone1                      |
| FirstName             | EmpStatus                | Phone1Ext                   |
| MiddleName            | HireDate                 | Phone2                      |
| Ssn                   | TermDate                 | Phone2Ext                   |
| BirthDate             | TermReason               | Phone3                      |
| Sex                   | RehireDate               | Phone3Ext                   |
| Ethnicity             | CostCenter1              | EmailAddress                |
| MaritalStatus         | CostCenter2              | PrimaryPayRate              |
| AddressLine1          | CostCenter3              | BaseRate                    |
| AddressLine2          | EmpType                  | DefaultHours                |
| City                  | Title                    | PayFrequency                |
| State                 | EeoClass                 | PayType                     |
| Zip                   | PayGroup                 | PrimaryPayRateEffectiveDate |
| PersonalMobilePhone   | Reviewer                 | Salary                      |
| Supervisor            | WorkLocation.address1    | WorkLocation.address2       |
| WorkLocation.city     | WorkLocation.state       | WorkLocation.postalCode     |
| WorkLocation.country  | WorkLocation.county      | WorkLocation.phone          |
| WorkLocation.phoneExt | WorkLocation.mobilePhone | WorkLocation.email          |

The JSON message sent consists of companyid and employeeid.

# Common use cases for these Webhooks

1. Sync change in employee data / metadata across company systems
2. Triggering an API GET request to re-poll all employee fields from HR & Payroll

> 📘 Implementation Notes
>
> * The Webhook notification triggers when any of the fields from the list above change.
> * Changes poll every minute, which might result in multiple notifications if several fields from the list change over one minute.
> * Don't rely on the Webhooks notification to provide all updated information fields, instead make a call to the relevant APIs to get the latest details; in some cases, especially related to employee information, a single user triggered change may result in additional automated system changes to that data object. Calls can be made using the company and ID values provided from the notification.

***

# 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", |
| employeeId | string | The employee's unique identifier.   | "employeeId": "12345",    |
|            |        |                                     | }                         |

## Code Example

```javascript JSON
{
  "companyId":"GC3456789",
  "employeeId":"12345"
}
```

> 📘 Additional Information
>
> Paylocity reserves the right to impose [rate limits](https://developer.paylocity.com/integrations/reference/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.