> ## Documentation Index
> Fetch the complete documentation index at: https://nango.dev/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Paycor

## Overview

<CardGroup cols={3}>
  <Card title="Pre-built tooling" icon="screwdriver-wrench" href="#pre-built-tooling" />

  <Card title="Pre-built integrations" icon="square-check" href="#pre-built-integrations" />

  <Card title="Access requirements" icon="triangle-exclamation" href="#access-requirements" />

  <Card title="Setup guide" icon="rocket" href="#setup-guide" />

  <Card title="Useful links" icon="circle-info" href="#useful-links" />

  <Card title="API gotchas" icon="biohazard" href="#api-gotchas" />
</CardGroup>

## Pre-built tooling

<AccordionGroup>
  <Accordion title="✅ Authorization">
    | Tools                           | Status |
    | ------------------------------- | ------ |
    | Pre-built authorization (OAuth) | ✅      |
    | Credentials auto-refresh        | ✅      |
    | Auth parameters validation      | ✅      |
    | Pre-built authorization UI      | ✅      |
    | Custom authorization UI         | ✅      |
    | End-user authorization guide    | ✅      |
    | Expired credentials detection   | ✅      |
  </Accordion>

  <Accordion title="✅ Read & write data">
    | Tools                                     | Status                         |
    | ----------------------------------------- | ------------------------------ |
    | Pre-built integrations                    | 🚫 (time to contribute: \<48h) |
    | API unification                           | ✅                              |
    | 2-way sync                                | ✅                              |
    | Webhooks from Nango on data modifications | ✅                              |
    | Real-time webhooks from 3rd-party API     | 🚫 (time to contribute: \<48h) |
    | Proxy requests                            | ✅                              |
  </Accordion>

  <Accordion title="✅ Observability & data quality">
    | Tools                   | Status |
    | ----------------------- | ------ |
    | HTTP request logging    | ✅      |
    | End-to-end type safety  | ✅      |
    | Data runtime validation | ✅      |
    | OpenTelemetry export    | ✅      |
    | Slack alerts on errors  | ✅      |
    | Integration status API  | ✅      |
  </Accordion>

  <Accordion title="✅ Customization">
    | Tools                              | Status                         |
    | ---------------------------------- | ------------------------------ |
    | Create or customize use-cases      | ✅                              |
    | Pre-configured pagination          | 🚫 (time to contribute: \<48h) |
    | Pre-configured rate-limit handling | 🚫 (time to contribute: \<48h) |
    | Per-customer configurations        | ✅                              |
  </Accordion>
</AccordionGroup>

*No pre-built syncs or actions available yet.*

<Tip>Not seeing the integration you need? [Build your own](/guides/functions/functions-guide) independently.</Tip>

## Access requirements

| Pre-Requisites    | Status | Comment                                                                                                                          |
| ----------------- | ------ | -------------------------------------------------------------------------------------------------------------------------------- |
| Paid dev account  | ✅      | You need a Paycor developer account with access to **AppCreator** to register your OAuth app and get client credentials.         |
| Paid test account | ❌      | Paycor provides a **sandbox environment** (`hcm-demo.paycor.com`) for testing OAuth flows — no paid test account required.       |
| Partnership       | ✅      | You typically need to be an [approved partner](https://developers.paycor.com/join-developer-portal) to create applications.      |
| App review        | ✅      | Maybe required if you want to submit your integration to the [Paycor Marketplace](https://marketplace.paycor.com/en-US/listing). |
| Security audit    | ✅      | Not required.                                                                                                                    |

## Setup guide

<Steps>
  <Step title="Create a developer account">
    1. Navigate to [developers.paycor.com](https://developers.paycor.com).
    2. Click **Sign Up** on the home screen for existing Paycor Clients.
    3. Click **Get Started**.
    4. Enter your Username and Password.
    5. Click **Sign In**.
    6. Select whom you would like to be the Admin of the Developer Portal Account.
    7. Click **Request Access**.
    8. Sign out then Sign In again using your previously used credentials.

    > **Note**: The account creation process can take up to 5 minutes to complete. Sign out, then sign back in to access Paycor's Developer Portal.

    Once access has been granted to the designated admin, they will receive an email that invites them to the developer portal.
  </Step>

  <Step title="Build your application">
    1. Click **Applications** on the home screen to get started.
    2. Click the **+ Application** button to create a new application, enter your application name.
    3. Select an **Application Type**: **Standard Application**: For general API access.
    4. Click **Create Application**
    5. **Copy & Save** the **Application OAuth Client ID** and **Application OAuth Client Secret** as you will need them when configuring your integration in Nango.
    6. Click **Got it**
    7. Navigate to the **Security Connections** tab to get your **API Subscription Key** (you will need to add this to your Nango connection configuration) and add `https://api.nango.dev/oauth/callback` as the **Approved Return OAuth URL**.
    8. Navigate to the **Data Access** tab and select your required Access scopes. This will generate a new version of the scope. You can find the **Scope Name** in the **General** tab, which you will need when configuring your integration in Nango.
  </Step>
</Steps>

<Tip>Need help getting started? Get help in the [community](https://nango.dev/slack).</Tip>

<Note>Contribute improvements to the setup guide by [editing this page](https://github.com/nangohq/nango/tree/master/docs/integrations/all/paycor.mdx)</Note>

## Useful links

* [API Documentation](https://developers.paycor.com/guides#welcome)
* [API Reference](https://developers.paycor.com/explore)
* [API Authentication](https://developers.paycor.com/guides#authorization)
* [How to create an OAuth application](https://developers.paycor.com/guides#step-2-build-application)

<Note>Contribute useful links by [editing this page](https://github.com/nangohq/nango/tree/master/docs/integrations/all/paycor.mdx)</Note>

## API gotchas

* **Scope Name Generation**: After selecting your required Access scopes in the Data Access tab, Paycor generates a new version of the scope. You can find the **Scope Name** in the **General** tab, which you must add to your Nango Paycor integration configuration.
* **Subscription Key Required**: You need to add your **API Subscription Key** (found in the Security Connections tab) as a connection configuration parameter in Nango for all API calls to work properly. See [creating a connect session documentation](/reference/api/connect/sessions/create#body-integrations-config-defaults) for details on how to add `subscriptionKey` to your `connection_config` when creating a Nango session.

<Note>Contribute API gotchas by [editing this page](https://github.com/nangohq/nango/tree/master/docs/integrations/all/paycor.mdx)</Note>

## Going further

<Card title="Connect to Paycor" icon="link" href="/integrations/all/paycor/connect" horizontal>
  Guide to connect to Paycor using Connect UI
</Card>