The Paylocity integration enables security and compliance teams to automatically synchronize employee data from Paylocity. This allows Drata to collect evidence related to personnel hire dates, termination dates, and employment status to support compliance monitoring and audit readiness
Prerequisites & Data Access
Paylocity Access Requirements
You must have Admin access in your Paylocity account.
You must obtain Paylocity API credentials by submitting a Paylocity Web Services Access Request Form.
Paylocity will provide the required Client ID and Client Secret after the request is approved.
Note: There may be a cost associated with enabling the Paylocity API and obtaining credentials from Paylocity.
Drata Role Requirements
To create or modify connections, you must have one of the following Drata roles with write access: Admin, Workspace Manager, or DevOps Engineer
Access Reviewers can view the connection page but cannot create or modify connections
Permissions & Required Access
Permission | Why It’s Needed |
Client ID | Identifies the Paylocity API application |
Client Secret | Authenticates the Paylocity integration |
Company ID | Identifies the Paylocity company being connected |
Step 1: Submit a Paylocity Web Services Access Request
Download and complete the Paylocity Web Services Access Request Form.
Provide the required details
Client Contact Information: Enter contact details for someone at your company (for example, an HR administrator).
Vendor / Third-Party Contact Information: Enter information about the integration provider.
Use Case Description: Describe the integration use case and include the following statement: "We are using Merge to connect."
Select the required API permissions.
Note:
The Get Employee permission is required to authenticate the integration.
Only select additional permissions that your integration requires.
Expected outcome:
The access request form is completed with the required permissions.
Step 2: Send the Request to Paylocity
Email the completed form to: [email protected]
The email body should contain the following:
Subject: Requesting Client ID and Client Secret
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.
Expected outcome:
Paylocity processes the request and provides your Client ID and Client Secret.
Step 3: Retrieve Your Company ID
Your Company ID is the identifier used when logging into Paylocity.
You can find it in the upper-left corner of the Paylocity portal.
Important:
If the ID includes CS, only enter the number that follows it.
Company IDs are case-sensitive.
Example:
If the ID is:
CS12345Enter:
12345
Expected outcome:
You have identified the Company ID required for the connection.
Step 4: Connect Paylocity in Drata
Log in to Drata → go to the Connections page.
Navigate to your Available Connections.
Search for and start the Paylocity connection process.
Enter the following information when prompted:
Client ID
Client Secret
Company ID
Expected outcome:
Paylocity is successfully connected and employee data begins syncing to Drata.
Important Notes
Credential expiration: Paylocity API credentials may need to be renewed periodically. Update the connection in Drata before credentials expire to avoid interruptions.
Multiple companies: If your Paylocity account includes multiple companies, additional Company IDs may be entered during the connection process.
Duplicate employees: Employees who work across multiple companies may appear multiple times in the synced data.
Additional Resources
Paylocity API documentation
