--- title: "Connect Pigment with Paylocity" slug: "connect-paylocity" description: "Learn how to connect Paylocity with Pigment to import your data seamlessly. Follow our step-by-step guide for API access and configuration." tags: ["API Access", "Importing Exporting Data", "Paylocity Integration", "Pigment Connector"] updated: 2025-10-23T12:17:24Z published: 2025-10-23T12:17:24Z --- > ## Documentation Index > Fetch the complete documentation index at: https://kb.pigment.com/llms.txt > Use this file to discover all available pages before exploring further. # Connect Pigment with Paylocity ![](https://cdn.document360.io/e47cfe35-dc28-40c7-a083-6cf003073d8e/Images/Documentation/image(26).png) This article explains how to connect Paylocity with Pigment to retrieve your data into a Pigment Block. ## Preliminary steps on Paylocity’s side Before starting the configuration in Pigment, it is required to request API Access from Paylocity, following [this documentation](https://paylocity.egain.cloud/system/templates/selfservice/pctycss/help/customer/locale/en-US/portal/308600000001020/content-version/PCTY-59754/PCTY-991490/Request-API-Access). If you have already done it and have a Client ID and a Client Secret, you can skip to the next section: Setting up the Paylocity Connector in Pigment. For Step 2 of the request process you will need to fill a [PDF](https://7523197.fs1.hubspotusercontent-na1.net/hubfs/7523197/KB%20Images/Paylocity%20Web%20Services_Access%20Request.pdf) and send it to Paylocity at [service@paylocity.com](mailto:service@paylocity.com). Here are the Pigment-related info you should add to get the necessary credentials and permissions: - **Vendor/Third-Party Contact Information** (see below) - **Request Type** (New Access for Company IDs listed above → PRODUCTION) - **Open API Access** (Employee → Get Employee → Unrestricted) ### Vendor Contact info **Vendor/Third-Party Name**: Pigment **Vendor/Third-Party Contact Name**: *enter your Solution Architect’s name* **Vendor/Third-Party Contact Email**: integrations@gopigment.com ![](https://cdn.document360.io/e47cfe35-dc28-40c7-a083-6cf003073d8e/Images/Documentation/94658a71-2021-4f9d-903b-6e3225931ea4.png) ![](https://cdn.document360.io/e47cfe35-dc28-40c7-a083-6cf003073d8e/Images/Documentation/faac40b5-8272-4979-8e70-f1840f46d5da.png) ![](https://cdn.document360.io/e47cfe35-dc28-40c7-a083-6cf003073d8e/Images/Documentation/f6cec4d2-c0d0-4008-9430-65d3817e3047.png) ## Setting up the Paylocity Connector in Pigment Once you have your API credentials from Paylocity, you can start configuring the connector in Pigment. From your Workspace homepage, navigate to **Settings** → **Integrations** and click on **+ Add** next to the Paylocity integration. > [!WARNING] > **⚠️****Important** > > You need to be a [Pigment Workspace Admin](https://community.gopigment.com/getting-started-86/how-to-add-users-and-modify-account-types-in-pigment-286) to be allowed to configure the connector. ![](https://cdn.document360.io/e47cfe35-dc28-40c7-a083-6cf003073d8e/Images/Documentation/e8fa540e-f99d-4214-989c-bee6d35f06c6.png) Click on **Setup a Connection** and then fill in the following fields The fields of Name and Application will remain editable if you need to add additional applications or rename. - **Name**: give a name to your connection (ex: “Paylocity connection”) - **Application Access**: list of applications that will be allowed to use this connection - **Client ID**: the Client ID provided by Paylocity following the first step - **Client secret**: the Client Secret provided by Paylocity following the first step - **Company ID**: ID of the company in Paylocity that you want to import data from Then click **Connect**. ![](https://cdn.document360.io/e47cfe35-dc28-40c7-a083-6cf003073d8e/Images/Documentation/3b450b3c-4127-4603-b15e-86d6c99a76f6.png) Click on **Setup**to finish! > [!WARNING] > **⚠️****Important** > > The client secret from Paylocity **expires every 365 days**. At the time of writing, Paylocity sends an email 10 days and then 5 days before expiration, along with a code that you can use to generate a new client secret. Check Paylocity’s documentation on how to [obtain a new client secret](https://developer.paylocity.com/integrations/reference/add-client-secret). > > Once you generated a new client secret, you can seamlessly edit this field in Pigment following [this documentation](/v1/docs/edit-pigment-integration-connections). ## Load Paylocity data into Pigment Once the Paylocity Connection is configured, navigate to an Application where the connection is available. From there click “Import Data” for the object you want to import data into. For example, if you were importing into a Transaction List, you would open up the list, then select **Import and Download**and then**Import data.** ![](https://cdn.document360.io/e47cfe35-dc28-40c7-a083-6cf003073d8e/Images/Documentation/d26a205d-a246-4011-8bf8-8bbe257b6c38(1).png) Click on the **Integration** tab and select the previously configured Paylocity Connection from the dropdown. > [!NOTE] > ℹ️ **Note** > > This step might take a while, up to 10 minutes, as the connector needs to retrieve employee information one by one. You will see a progress indicator with the number of employees retrieved next to the button as shown below. ![](https://cdn.document360.io/e47cfe35-dc28-40c7-a083-6cf003073d8e/Images/Documentation/3fc0a013-c72b-48bb-806a-5e07e128bf76.png) If you do not see the Paylocity connection you have configured, make sure the current application is listed under the authorized applications for this connection. To fix this, go back to the setting’s Integrations page, and check that the Application is on the *Application Access* list.