Skip to main content

​
Overview

To authenticate with Paylocity, you will need:
  1. Environment - Your Paylocity environment (testing or production).
  2. Company ID - The unique identifier for your Paylocity company.
  3. Client ID - A key that is used to identify your Paylocity application.
  4. Client Secret - A secret key used in conjunction with the Client ID to grant Nango permission to access Paylocity’s API resources and services.
This guide will walk you through finding these within Paylocity.

​
Prerequisites:

  • You must have a registered Paylocity account.

​
Instructions:

​
Step 1: Select the Correct Paylocity Environment

Paylocity offers two environments for API access. Choose the one that matches your use case:
EnvironmentBase URLPurpose
Testinghttps://dc1demogwext.paylocity.comSafe testing environment with test data.
Productionhttps://dc1prodgwext.paylocity.comLive data for real-world use.
Note: Use dc1demogwext for testing and development, and dc1prodgwext for production environments.

​
Step 2: Find Your Company ID

  1. Log in to your Paylocity portal.
  2. Locate your Company ID in the upper left-hand corner of the dashboard.

​
Step 3: Obtain Your Client Credentials

To get your Client ID and Client Secret, you need to request API access from Paylocity:
  1. Download and fill out the Paylocity Web Services Access Request Form.
  2. Select all the permissions you want to use for your integration.
  3. Email your completed form to [email protected].
Email Template: Subject: Requesting Client ID and Client Secret Email Body: 
Hi Paylocity team, can we get access to a Client ID and Client Secret for API access? (https://www.paylocity.com/our-products/integrations/api-library/) We have attached the form specifying relevant permissions.
There may be a cost associated with the API setup & gathering of credentials from Paylocity. Secrets are required to be rotated once every 365 days. An email notification of your secret expiring is sent to the identified contact 10 days and 5 days prior to the expiration.
  1. Once Paylocity processes your request, you will receive your Client ID and Client Secret.

​
Step 4: Connect Your Paylocity Account

Once you have your Environment, Company ID, Client ID, and Client Secret:
  1. Open the form where you need to authenticate with Paylocity.
  2. Enter your Environment (either dc1demogwext or dc1prodgwext).
  3. Enter your Company ID.
  4. Enter your NextGen Client ID and Client Secret in their respective fields.
  5. Submit the form, and you should be successfully authenticated.
You are now connected to Paylocity (NextGen).