Skip to main content

Authorization

Follow this guide to create a new Paycor credential that will allow Nexla to authenticate to and exchange data with your Paycor account.
paycor_api_auth.png

Paycor

Prerequisites​

Before creating a Paycor credential, you'll need to create an application in the Paycor Developer Portal and obtain OAuth 2.0 credentials (Client ID and Client Secret) along with an APIM Subscription Key. Paycor requires dual authentication: OAuth 2.0 Bearer token + APIM Subscription Key header. Both are mandatory for all API requests.

To obtain Paycor API credentials:

  1. Log in to the Paycor Developer Portal with your Paycor account credentials.

  2. Navigate to My Apps or Applications section in the developer portal.

  3. Click Create Application or New Application to create a new application for API access.

  4. Fill in the application details including name, description, and other required information.

  5. After creating the application, you'll receive a Client ID and Client Secret. Copy these credentials immediately, as the Client Secret may only be displayed once.

  6. Navigate to Security Connections or API Management section in your Paycor account settings.

  7. Locate the APIM Subscription Key section. This key is required for all API requests and must be sent as the ocp-apim-subscription-key header.

  8. Copy the APIM Subscription Key. Store it securely, as you'll need it for all API requests.

  9. Note your Legal Entity ID (also known as Client ID). This is the unique identifier for your Paycor company/legal entity and is required for data access. You can find this in your Paycor account settings or by contacting Paycor support.

  10. Configure Data Access scopes for your application. Ensure your application has the necessary permissions to access the data you need (e.g., employee data, payroll information, time and attendance).

Paycor requires dual authentication: OAuth 2.0 Bearer token + APIM Subscription Key header. Both are mandatory for all API requests. The OAuth 2.0 credentials are used to obtain an access token, which is then sent as a Bearer token in the Authorization header. The APIM Subscription Key must be sent as the ocp-apim-subscription-key header in all requests. The Legal Entity ID is required to access company-specific data.

For detailed information about Paycor API authentication and application setup, refer to the Paycor Developer Guides.

Create a Paycor Credential​

  • To create a new Paycor credential, after selecting the data source/destination type, click the Add Credential tile to open the Add New Credential overlay.

New Credential Overlay – Paycor

PaycorCred.png

Credential Name & Description​

  1. Enter a name for the credential in the Credential Name field and a short, meaningful description in the Credential Description field.

    Resource descriptions are recommended but are not required. They should be used provide information about the resource purpose, data freshness, etc. that can help the owner and other users efficiently understand and utilize the resource.

Credential Settings​

  1. In the Client ID field, enter the Client ID that you obtained from your Paycor application in the Developer Portal. This is the unique identifier for your registered application.

  2. In the Client Secret field, enter the Client Secret that you obtained from your Paycor application in the Developer Portal. This is the secret value used to obtain OAuth 2.0 access tokens.

    The Client Secret is sensitive information and should be kept secure. If you've lost your Client Secret, you'll need to generate a new one in your Paycor Developer Portal application settings.

  3. In the APIM Subscription Key field, enter the APIM Subscription Key that you obtained from the Security Connections section of your Paycor account. This key is required for all API requests and must be sent as the ocp-apim-subscription-key header.

    The APIM Subscription Key is sensitive information and should be kept secure. This key is mandatory for all Paycor API requests and must be included in the request headers.

  4. In the Legal Entity ID field, enter your Paycor Legal Entity ID (Client ID) for the specific company data access. This is the unique identifier for your Paycor company/legal entity and is required to access company-specific data.

Save the Credential​

  1. Once all of the relevant steps in the above sections have been completed, click the Save button at the bottom of the overlay to save the configured credential.

  2. The newly added credential will now appear in a tile on the Authenticate screen during data source/destination creation and can be selected for use with a new data source or destination.