Skip to main content

​
Prerequisites

Before continuing, you should have already completed the following for this connector:
1

Configure the Connector

Enable the connector and set up its connector profile in your project. See Managing Connectors.

Connector Profile

Paylocity - OAuth 2.0
2

Link an Account

Connect an account using StackOne Hub or Auth Link.

Link Account

Paylocity - OAuth 2.0

​
Configure Paylocity Webhooks

Paylocity delivers event notifications as lightweight JSON payloads to an HTTP endpoint you register with Paylocity. Because Paylocity manages webhook registration centrally, you must contact Paylocity support or your partner liaison to enable webhooks on your account and provide them with the StackOne Native Webhook URL.

1

Retrieve the StackOne Native Webhook URL

The Native Webhook URL is generated once a connector profile has been set up in StackOne. You will need this URL when contacting Paylocity to enable webhooks.

  • Open the StackOne Hub form to connect with Paylocity in StackOne.
  • Copy the URL from Native Webhook URL.
2

Contact Paylocity to enable webhooks

Paylocity does not provide a self-service webhook configuration UI. Send a request to Paylocity support or your dedicated partner liaison to activate webhooks on your account.

  • Email: service@paylocity.com (or contact your assigned Paylocity partner liaison).
  • Provide the Native Webhook URL copied from StackOne.
  • Specify which event types you want enabled: New Hire, Employee Change, Employee Termination, Payroll Processed, and/or Time Off Approval.
3

IP allowlist

Paylocity sends webhook requests from the following IP ranges. Ensure your firewall or network rules allow inbound traffic from these ranges to the StackOne webhook endpoint.

  • 198.245.157.0/24
  • 192.40.49.0/24
4

Supported events and payload notes

The following event types are available. Paylocity payloads are intentionally lightweight — they contain identifiers only. Use the companyId and employeeId (or processId) to fetch full record details from the Paylocity API.

  • New Hire: 32-field payload including employeeHireDate, employeeFirstName, employeeLastName, and other demographic fields.
  • Employee Change: Minimal payload containing only companyId and employeeId. Call the API to determine what changed.
  • Employee Termination: Payload includes companyId, employeeId, employee name, cost centres, and employeeTerminationDate.
  • Payroll Processed: Payload includes companyId, processId, checkDate, runId, processDate, and status.
  • Time Off Approval: Payload includes companyId, employeeId, employeeName, supervisorWorkEmail, timeOffStartDate, timeOffEndDate, isAllDayEvent, and hoursPerDay. Only approval events are sent — cancellations and changes do not trigger webhooks.
  • Retry policy: failed deliveries are retried every 30 minutes for up to 24 hours.

​
Verify

Your Connector should now be able to receive and process events. Try triggering an event and you should see an Event appear in the Connector logs.