GuidesRecipesAPI ReferenceChangelog
Guides

Webhooks Overview

Paylocity Webhooks is a notification system that allows events to trigger notifications.

When events occur, a JSON message containing information about the event sends as a POST to a client-specified endpoint URL over HTTPS.

The URL can either require basic authentication, which is just a username and password, or you have the option to not require a username and password. For additional data protection, Paylocity recommends securing the URL with a username and password authentication.

It is recommended to use only the Company and ID values from the Webhook to call the API to receive relevant data for the employee rather than relying entirely on the Webhook notification. Additionally, coding should be in place to expect null values for the fields sent in the Webhook notification.

Webhooks supports requests up to TLS 1.2.

Company Administrator users can utilize the Webhook Log to verify and resend webhooks when necessary. Not all webhooks are considered undeliverable. Review Queue Undeliverable Webhooks and Undeliverable Webhooks for additional information.

Below are the automation triggers currently supported with webhooks from the Integrations platform. Paylocity is in the process of adding more triggers based on company input and business requirements.

📘

Automation triggers currently supported with Webhooks

The vendor/client may need to add the Paylocity IP addresses to their firewall if they need to filter by IP address on their side to allow for the Webhooks to be received.

📘

These are the IP addresses that are used for our webhooks:

  • 198.245.157.0/24
  • 192.40.49.0/24

For additional guidance, see future dated change webhooks.


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