# Integrating with Paylocity

[Prerequisites](#prerequisites)

[Paylocity Setup](#paylocity-setup)\
   [Step One: Getting your Company ID](#step-1-getting-your-company-id)\
   [Step Two: Getting your client ID and Secret](#step-2-getting-your-client-id-and-secret)

## Prerequisites

To connect Paylocity to Drivetrain, you need:

* An active Paylocity account along with the below details:
  * Company ID
  * Client ID
  * Client Secret
* Admin privileges in Drivetrain

## Paylocity Setup <a href="#paylocity-setup" id="paylocity-setup"></a>

You can integrate Drivetrain with Paylocity using access tokens that Paylocity shares with you.

### Step 1: Getting your Company ID <a href="#step-1-getting-your-company-id" id="step-1-getting-your-company-id"></a>

Your Company ID is available on the upper left hand corner of your Paylocity portal.

### Step 2: Getting your Client ID and Secret <a href="#step-2-getting-your-client-id-and-secret" id="step-2-getting-your-client-id-and-secret"></a>

1. Fill out the Paylocity Web Services Access Request Form: Use this link to access the Request Form - <https://docs.paylocity.com/Knowledge/Partner>[Integration/Paylocity Web Services\_Access Request.pdf](https://app.gitbook.com/s/xk5QIoB2UA1qxCweAfEf)

In the 'Client Contact Information' section of the form, provide information of someone from your company (for example, the details of a HR personnel).

In the 'Vendor / Third Party Contact Information' section, provide Drivetrain's information.

Under 'Briefly describe use case', describe that you wish to use Drivetrain for business reporting purposes.

<figure><img src="/files/0vLUL5AOmbvmJCtkp828" alt=""><figcaption></figcaption></figure>

You can ignore the "Webhook Push Notifications" section.

If you need information on Pay Statements, Deductions, & Earnings fill out the following:

<figure><img src="/files/KD8YbhPHlqPTu8j47nrW" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
'Get Employee' is a required permission to authenticate the linking flow, but only endpoints needed for your integration should be selected. For example, if you don’t need Pay Statements, Deductions, or Earnings, remove those from the permissions.
{% endhint %}

2. Send your completed form to <webservices@paylocity.com>

The email 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.

{% hint style="info" %}
That’s it! Share the Client ID and Client Secret with your customer success manager so that they can get started!
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://integrations.drivetrain.ai/integration-guide/integrate-with-drivetrain/hris-and-ats/integrating-with-paylocity.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.