Setup Paylocity

Demo Video

Please review this demo video that shows webhook functionality with Paylocity:

Webhook Connectivity

You will need to request Paylocity to setup webhook for your use cases e.g. new hire, termination, etc. This link provides more information about their process. Use the form specified in step-4 to provide relevant details. The URL, username and password can be copied once new webhooks are created in OnLink. See this link for reference.

Once you have authorization, you can create a new webhook in OnLink with Paylocity as the system and the below config:

map:employeeFirstName=customfield_10122
map:employeeLastName=customfield_10123
config:summary='Paylocity Inbound: ', [0], ' ', [1]
config:auth_scheme=basic_auth
config:auth_username=<enter a username>
config:auth_password=<enter a password>

Additional mapping fields can be added. See Mapping section below for common fields you can map from Paylocity.

API Connectivity

You will need to request Paylocity for API credentials. This link provides more info on the information you will receive when API Access is granted i.e., client id and client secret.

The Paylocity connector lets you connect to a Paylocity instance and access Paylocity HR resources using their published APIs.

• URL:

  • For production: https://api.paylocity.com/

  • For testing: https://apisandbox.paylocity.com/

• Client ID: this is the client_id you receive from Paylocity

• Client secret: this is the secret you receive from Paylocity

Ref: https://prod.cdn.paylocity.com/developer/index.html

The Paylocity APIs provide information about employees only when their effective dates become active i.e., they fall within the current pay period. Our apps are limited by this as well and as and when Paylocity enhances their API’s, our apps will be able to leverage their new functionality.

Mapping

Here are some common fields you can map from Paylocity

employeeId
employeeJobTitle
employeeFirstName
employeeLastName
employeeHireDate
employeeGender
employeeSupervisor
employeeSupervisorId
employeeType
employeeWorkEMailAddress
employeeWorkPhone
employeeCity
employeeZip

More fields can be found in this link.