--- title: "Paychex API Directory" url: "https://getknit.dev/blog/paychex-api-directory/" date: "2024-10-28T16:49:22+00:00" modified: "2026-08-29T11:31:42+00:00" type: "post" --- # Paychex API Directory [Blog](https://getknit.dev/blog) / [API Directory](https://getknit.dev/blogs/api-directory/) / Paychex API Directory [API Directory](https://getknit.dev/blogs/api-directory/) · October 28, 2024 · Updated August 29, 2026 Paychex API Directory ===================== ![](https://storage.googleapis.com/knit-website-media/2026/08/64c34c8eb1ffc79e7f787ecd_Akshat-3-112x112.png)Akshat Jain 9 min read [](https://www.linkedin.com/sharing/share-offsite/?url=https%3A%2F%2Fgetknit.dev%2Fblog%2Fpaychex-api-directory%2F) [](https://twitter.com/intent/tweet?url=https%3A%2F%2Fgetknit.dev%2Fblog%2Fpaychex-api-directory%2F&text=Paychex%20API%20Directory) Table of Contents - [Paychex API Endpoints](#paychex-api-endpoints) - [Paychex API FAQs](#paychex-api-faqs) - [Get started with Paychex API](#get-started-with-paychex-api) Paychex is a payroll and HR solutions provider designed to simplify workforce management for businesses of all sizes. It offers a range of tools for payroll processing, employee benefits, time tracking, and compliance, helping companies streamline their HR tasks. ‍ With Paychex’s API, developers can integrate payroll, benefits, and other HR data with external applications, enabling automation and giving teams a single, consistent view of employee-related tasks across platforms. ‍ Here are some key highlights of the **Paychex APIs**: 1. **Payroll Processing**: Automate payroll calculations, deductions, and tax filings for smooth and timely payments. 2. **Employee Management**: Access and manage employee data, including personal details, employment status, and role-based permissions. 3. **Time and Attendance**: Track employee hours, manage time-off requests, and streamline attendance records for accurate payroll processing. 4. **Benefits Administration**: Integrate employee benefits data to easily manage enrollments, coverage updates, and compliance reporting. 5. **Compliance and Tax Data**: Access tax compliance data and generate reports to simplify filing and stay aligned with local, state, and federal regulations. 6. **Secure Authentication**: Uses OAuth 2.0 for secure data exchange, ensuring that sensitive payroll and employee information is protected. In this article, we will explore what are the most commonly used Paychex API endpoints and how they allow businesses to streamline their HR and payroll operations, making it easy to integrate Paychex services into existing workflows. ‍ **Paychex API Endpoints** ------------------------- Here are the most commonly used Paychex API endpoints – ‍ #### **Authentication** - POST #### Company - GET - GET [https://api.paychex.com/companies/{companyId](https://api.paychex.com/companies/%7BcompanyId)} - GET [https://api.paychex.com/companies/{companyId}/calculationbases](https://api.paychex.com/companies/%7BcompanyId%7D/calculationbases) - GET [https://api.paychex.com/companies/{companyId}/contacttypes](https://api.paychex.com/companies/%7BcompanyId%7D/contacttypes) - GET [https://api.paychex.com/companies/{companyId}/customfields](https://api.paychex.com/companies/%7BcompanyId%7D/customfields) - POST [https://api.paychex.com/companies/{companyId}/customfields](https://api.paychex.com/companies/%7BcompanyId%7D/customfields) - GET [https://api.paychex.com/companies/{companyId}/customfields/{customFieldId](https://api.paychex.com/companies/%7BcompanyId%7D/customfields/%7BcustomFieldId)} - DELETE [https://api.paychex.com/companies/{companyId}/customfields/{customfieldid](https://api.paychex.com/companies/%7BcompanyId%7D/customfields/%7Bcustomfieldid)} - PATCH [https://api.paychex.com/companies/{companyId}/customfields/{customfieldid](https://api.paychex.com/companies/%7BcompanyId%7D/customfields/%7Bcustomfieldid)} - GET [https://api.paychex.com/companies/{companyId}/customfieldscategories](https://api.paychex.com/companies/%7BcompanyId%7D/customfieldscategories) - POST [https://api.paychex.com/companies/{companyId}/customfieldscategories](https://api.paychex.com/companies/%7BcompanyId%7D/customfieldscategories) - GET [https://api.paychex.com/companies/{companyId}/customfieldscategories/{categoryId](https://api.paychex.com/companies/%7BcompanyId%7D/customfieldscategories/%7BcategoryId)} - DELETE [https://api.paychex.com/companies/{companyId}/customfieldscategories/{categoryid](https://api.paychex.com/companies/%7BcompanyId%7D/customfieldscategories/%7Bcategoryid)} - PATCH [https://api.paychex.com/companies/{companyId}/customfieldscategories/{categoryid](https://api.paychex.com/companies/%7BcompanyId%7D/customfieldscategories/%7Bcategoryid)} - GET [https://api.paychex.com/companies/{companyId}/jobs](https://api.paychex.com/companies/%7BcompanyId%7D/jobs) - POST [https://api.paychex.com/companies/{companyId}/jobs](https://api.paychex.com/companies/%7BcompanyId%7D/jobs) - GET [https://api.paychex.com/companies/{companyId}/jobs/{jobId](https://api.paychex.com/companies/%7BcompanyId%7D/jobs/%7BjobId)} - PATCH [https://api.paychex.com/companies/{companyId}/jobs/{jobId](https://api.paychex.com/companies/%7BcompanyId%7D/jobs/%7BjobId)} - GET [https://api.paychex.com/companies/{companyId}/jobsegments](https://api.paychex.com/companies/%7BcompanyId%7D/jobsegments) - GET [https://api.paychex.com/companies/{companyId}/jobtitles](https://api.paychex.com/companies/%7BcompanyId%7D/jobtitles) - GET [https://api.paychex.com/companies/{companyId}/jobtitles/{jobTitleId](https://api.paychex.com/companies/%7BcompanyId%7D/jobtitles/%7BjobTitleId)} - GET [https://api.paychex.com/companies/{companyId}/laborassignments](https://api.paychex.com/companies/%7BcompanyId%7D/laborassignments) - GET [https://api.paychex.com/companies/{companyId}/laborassignments/{laborAssignmentId](https://api.paychex.com/companies/%7BcompanyId%7D/laborassignments/%7BlaborAssignmentId)} - GET [https://api.paychex.com/companies/{companyId}/locations](https://api.paychex.com/companies/%7BcompanyId%7D/locations) - GET [https://api.paychex.com/companies/{companyId}/locations/{locationId](https://api.paychex.com/companies/%7BcompanyId%7D/locations/%7BlocationId)} - GET [https://api.paychex.com/companies/{companyId}/organizations](https://api.paychex.com/companies/%7BcompanyId%7D/organizations) - GET [https://api.paychex.com/companies/{companyId}/organizations/{orgId](https://api.paychex.com/companies/%7BcompanyId%7D/organizations/%7BorgId)} - GET [https://api.paychex.com/companies/{companyId}/payfrequencies](https://api.paychex.com/companies/%7BcompanyId%7D/payfrequencies) - GET [https://api.paychex.com/companies/{companyId}/workers](https://api.paychex.com/companies/%7BcompanyId%7D/workers) - POST [https://api.paychex.com/companies/{companyId}/workers](https://api.paychex.com/companies/%7BcompanyId%7D/workers) - GET [https://api.paychex.com/companies/{companyId}/workerstatuses](https://api.paychex.com/companies/%7BcompanyId%7D/workerstatuses) - GET [https://api.paychex.com/companies/{companyId}/workerstatuses/{statusId](https://api.paychex.com/companies/%7BcompanyId%7D/workerstatuses/%7BstatusId)} ‍ #### Payroll - GET [https://api.paychex.com/companies/{companyId}/checks](https://api.paychex.com/companies/%7BcompanyId%7D/checks) - POST [https://api.paychex.com/companies/{companyId}/checks](https://api.paychex.com/companies/%7BcompanyId%7D/checks) - GET [https://api.paychex.com/companies/{companyId}/paycomponents](https://api.paychex.com/companies/%7BcompanyId%7D/paycomponents) - GET [https://api.paychex.com/companies/{companyId}/paycomponents/{paycomponentId](https://api.paychex.com/companies/%7BcompanyId%7D/paycomponents/%7BpaycomponentId)} - GET [https://api.paychex.com/companies/{companyId}/payperiods](https://api.paychex.com/companies/%7BcompanyId%7D/payperiods) - GET [https://api.paychex.com/companies/{companyId}/payperiods/{payperiodId](https://api.paychex.com/companies/%7BcompanyId%7D/payperiods/%7BpayperiodId)} - GET [https://api.paychex.com/workers/{workerId}/checks](https://api.paychex.com/workers/%7BworkerId%7D/checks) - POST [https://api.paychex.com/workers/{workerId}/checks](https://api.paychex.com/workers/%7BworkerId%7D/checks) - GET [https://api.paychex.com/workers/{workerId}/checks/{externalCheckId](https://api.paychex.com/workers/%7BworkerId%7D/checks/%7BexternalCheckId)} - DELETE [https://api.paychex.com/workers/{workerId}/checks/{externalCheckId](https://api.paychex.com/workers/%7BworkerId%7D/checks/%7BexternalCheckId)} - DELETE - POST [https://api.paychex.com/checks/{checkId}/checkcomponents](https://api.paychex.com/checks/%7BcheckId%7D/checkcomponents) - DELETE [https://api.paychex.com/checks/{checkId}/checkcomponents/{checkComponentId](https://api.paychex.com/checks/%7BcheckId%7D/checkcomponents/%7BcheckComponentId)} - PATCH [https://api.paychex.com/checks/{checkId}/checkcomponents/{checkComponentId](https://api.paychex.com/checks/%7BcheckId%7D/checkcomponents/%7BcheckComponentId)} ‍ #### Worker - GET [https://api.paychex.com/workers/{workerId](https://api.paychex.com/workers/%7BworkerId)} - DELETE [https://api.paychex.com/workers/{workerId](https://api.paychex.com/workers/%7BworkerId)} - PATCH [https://api.paychex.com/workers/{workerId](https://api.paychex.com/workers/%7BworkerId)} - GET [https://api.paychex.com/workers/{workerId}/assignmentdistributions](https://api.paychex.com/workers/%7BworkerId%7D/assignmentdistributions) - GET [https://api.paychex.com/workers/{workerId}/communications](https://api.paychex.com/workers/%7BworkerId%7D/communications) - POST [https://api.paychex.com/workers/{workerId}/communications](https://api.paychex.com/workers/%7BworkerId%7D/communications) - GET [https://api.paychex.com/workers/{workerId}/communications/{communicationId](https://api.paychex.com/workers/%7BworkerId%7D/communications/%7BcommunicationId)} - DELETE [https://api.paychex.com/workers/{workerId}/communications/{communicationId](https://api.paychex.com/workers/%7BworkerId%7D/communications/%7BcommunicationId)} - PATCH [https://api.paychex.com/workers/{workerId}/communications/{communicationId](https://api.paychex.com/workers/%7BworkerId%7D/communications/%7BcommunicationId)} - GET [https://api.paychex.com/workers/{workerId}/compensation](https://api.paychex.com/workers/%7BworkerId%7D/compensation) - GET [https://api.paychex.com/workers/{workerId}/compensation/payrates](https://api.paychex.com/workers/%7BworkerId%7D/compensation/payrates) - POST [https://api.paychex.com/workers/{workerId}/compensation/payrates](https://api.paychex.com/workers/%7BworkerId%7D/compensation/payrates) - GET [https://api.paychex.com/workers/{workerId}/compensation/payrates/{rateId](https://api.paychex.com/workers/%7BworkerId%7D/compensation/payrates/%7BrateId)} - DELETE [https://api.paychex.com/workers/{workerId}/compensation/payrates/{rateId](https://api.paychex.com/workers/%7BworkerId%7D/compensation/payrates/%7BrateId)} - PATCH [https://api.paychex.com/workers/{workerId}/compensation/payrates/{rateId](https://api.paychex.com/workers/%7BworkerId%7D/compensation/payrates/%7BrateId)} - GET [https://api.paychex.com/workers/{workerId}/compensation/paystandards](https://api.paychex.com/workers/%7BworkerId%7D/compensation/paystandards) - GET [https://api.paychex.com/workers/{workerId}/contacts](https://api.paychex.com/workers/%7BworkerId%7D/contacts) - POST [https://api.paychex.com/workers/{workerId}/contacts](https://api.paychex.com/workers/%7BworkerId%7D/contacts) - GET [https://api.paychex.com/workers/{workerId}/contacts/{contactId](https://api.paychex.com/workers/%7BworkerId%7D/contacts/%7BcontactId)} - DELETE [https://api.paychex.com/workers/{workerId}/contacts/{contactId](https://api.paychex.com/workers/%7BworkerId%7D/contacts/%7BcontactId)} - PATCH [https://api.paychex.com/workers/{workerId}/contacts/{contactId](https://api.paychex.com/workers/%7BworkerId%7D/contacts/%7BcontactId)} - GET [https://api.paychex.com/workers/{workerId}/customfields](https://api.paychex.com/workers/%7BworkerId%7D/customfields) - POST [https://api.paychex.com/workers/{workerId}/customfields](https://api.paychex.com/workers/%7BworkerId%7D/customfields) - GET [https://api.paychex.com/workers/{workerId}/customfields/{workerCustomFieldId](https://api.paychex.com/workers/%7BworkerId%7D/customfields/%7BworkerCustomFieldId)} - DELETE [https://api.paychex.com/workers/{workerId}/customfields/{workerCustomFieldId](https://api.paychex.com/workers/%7BworkerId%7D/customfields/%7BworkerCustomFieldId)} - PATCH [https://api.paychex.com/workers/{workerId}/customfields/{workerCustomFieldId](https://api.paychex.com/workers/%7BworkerId%7D/customfields/%7BworkerCustomFieldId)} - GET [https://api.paychex.com/workers/{workerId}/directdeposits](https://api.paychex.com/workers/%7BworkerId%7D/directdeposits) - POST [https://api.paychex.com/workers/{workerId}/directdeposits](https://api.paychex.com/workers/%7BworkerId%7D/directdeposits) - PATCH [https://api.paychex.com/workers/{workerId}/directdeposits](https://api.paychex.com/workers/%7BworkerId%7D/directdeposits) - GET [https://api.paychex.com/workers/{workerId}/directdeposits/{directDepositId](https://api.paychex.com/workers/%7BworkerId%7D/directdeposits/%7BdirectDepositId)} - DELETE [https://api.paychex.com/workers/{workerId}/directdeposits/{directDepositId](https://api.paychex.com/workers/%7BworkerId%7D/directdeposits/%7BdirectDepositId)} - PATCH [https://api.paychex.com/workers/{workerId}/directdeposits/{directDepositId](https://api.paychex.com/workers/%7BworkerId%7D/directdeposits/%7BdirectDepositId)} - GET [https://api.paychex.com/workers/{workerId}/federaltax](https://api.paychex.com/workers/%7BworkerId%7D/federaltax) - POST [https://api.paychex.com/workers/{workerId}/federaltax](https://api.paychex.com/workers/%7BworkerId%7D/federaltax) - DELETE [https://api.paychex.com/workers/{workerId}/federaltax](https://api.paychex.com/workers/%7BworkerId%7D/federaltax) - PATCH [https://api.paychex.com/workers/{workerId}/federaltax](https://api.paychex.com/workers/%7BworkerId%7D/federaltax) - GET [https://api.paychex.com/workers/{workerId}/federaltax](https://api.paychex.com/workers/%7BworkerId%7D/federaltax) - POST [https://api.paychex.com/workers/{workerId}/paycomponents](https://api.paychex.com/workers/%7BworkerId%7D/paycomponents) - PATCH [https://api.paychex.com/workers/{workerId}/paycomponents](https://api.paychex.com/workers/%7BworkerId%7D/paycomponents) - GET [https://api.paychex.com/workers/{workerId}/paycomponents/{workerComponentId](https://api.paychex.com/workers/%7BworkerId%7D/paycomponents/%7BworkerComponentId)} - DELETE [https://api.paychex.com/workers/{workerId}/paycomponents/{workerComponentId](https://api.paychex.com/workers/%7BworkerId%7D/paycomponents/%7BworkerComponentId)} - PATCH [https://api.paychex.com/workers/{workerId}/paycomponents/{workerComponentId](https://api.paychex.com/workers/%7BworkerId%7D/paycomponents/%7BworkerComponentId)} - GET [https://api.paychex.com/workers/{workerId}/status](https://api.paychex.com/workers/%7BworkerId%7D/status) - GET [https://api.paychex.com/workers/{workerId}/timeoff](https://api.paychex.com/workers/%7BworkerId%7D/timeoff) ‍ #### Management - POST ‍ #### Webhooks - GET - GET - POST - GET [https://api.paychex.com/management/hooks/{hookId](https://api.paychex.com/management/hooks/%7BhookId)} - DELETE [https://api.paychex.com/management/hooks/{hookId](https://api.paychex.com/management/hooks/%7BhookId)} ‍ [Here’s a detailed reference](https://developer.paychex.com/documentation#section/Developer-Resources) to all the Paychex API Endpoints. **Paychex API FAQs** -------------------- Here are the frequently asked questions about Paychex APIs to help you get started: ‍ #### Do Paychex APIs support pagination? Yes. Knit works with paginated payroll APIs like Paychex every day, so its unified API handles the paging logic for you instead of leaving it to your team. On the Paychex side, list endpoints accept `offset` and `limit` query parameters (for example `?offset=5&limit=5`), and Paychex recommends paging at 100 items per page for companies with a large worker count to avoid long runtimes and timeouts. Responses include hypermedia `next`, `previous`, and `self` links plus a `pagination` object with the offset, limit, and total item count, so you can walk through results without guessing at page boundaries. See Paychex’s own [paging documentation](https://developer.paychex.com/resources/paging) for the full spec. #### What is the rate limit on Paychex API endpoints? Paychex does not publish a fixed numeric rate limit (no fixed requests-per-second or per-minute figure), which is exactly the kind of ambiguity Knit is built to absorb for you: its integration layer backs off and retries automatically so a spike in one workflow doesn’t take down another. Paychex instead states that it monitors for excessive calls and will reach out directly if an integration approaches its internal limit, so the practical guidance is to keep call volume reasonable and avoid unnecessary polling. Details are in Paychex’s [rate-limiting documentation](https://developer.paychex.com/resources/rate-limiting). #### What happens when I POST new workers via the Paychex API, and what are the required fields? Creating a worker only requires three fields: given name, family name, and worker type (`EMPLOYEE` for W-2 staff or `INDEPENDENT_CONTRACTOR` for 1099 workers), and Knit’s employee-data models map cleanly onto that same minimal schema so you don’t have to special-case Paychex in your own worker-creation flow. A new worker starts in an `IN_PROGRESS` status and only moves to `ACTIVE` once all required fields are complete; adding an email or mobile number at creation time also triggers an automatic onboarding invite in Paychex Flex. Full details are in Paychex’s [worker documentation](https://developer.paychex.com/resources/worker). #### How do I specify a vendor media type profile in Paychex API requests, and is it required for each call? It’s optional. Knit normalizes these vendor-specific response formats behind a single schema, which matters here because Paychex media type profiles (passed in the request’s `Accept` header, for example `application/vnd.paychex.association_companies.v1+json`) change the shape of the response for a given endpoint. Every resource has a default profile, so calls succeed without specifying one; you only add a profile when you need a specific response version or structure. See Paychex’s [vendor media type documentation](https://developer.paychex.com/resources/vendor-media-type) for the available profiles. #### What are the predefined headers used in Paychex API requests and responses? Requests carry an `Authorization` header with a bearer access token and an optional `X-payx-client-correlationId` that Paychex recommends generating per request for troubleshooting; Knit passes these through automatically so individual API calls made through its unified layer stay traceable back to Paychex support tickets when something needs debugging. Responses come back with `Content-Type` (the vendor media type), caching headers (`Cache-Control`, `Expires`), a server-generated `X-payx-txid` for tracking, and an `ETag` on paginated resources. Full reference in Paychex’s [headers documentation](https://developer.paychex.com/resources/headers). Find more FAQs [here](https://developer.paychex.com/resources/frequently-asked-questions). ‍ **Get started with Paychex API** -------------------------------- To access Paychex APIs, create a Paychex account and log in to the Developer Portal. Apply for API access, and upon approval, you’ll receive your API credentials (client ID and secret). Use these for OAuth 2.0 authentication to securely access the API endpoints. Review the documentation for integration guidelines. ‍ If you’re looking for a quick way to connect multiple Payroll systems, consider using Knit, a single API solution that integrates with major platforms, streamlining your setup and reducing development time. To sign up for free, [click here](https://dashboard.getknit.dev/signup). To check the pricing, see our [pricing page](/pricing/). Building a Paychex integration? Knit gives you two ways to build it. Pick the one that fits. - [Paychex on Unified API](https://getknit.dev/integration/paychex/) Your customers want Paychex and the other HRIS tools they use. Build one integration and get normalised read and write data with real-time webhooks. [Try free](https://dashboard.getknit.dev/signup) - [Paychex MCP server](https://getknit.dev/mcp-servers/paychex-mcp-server/) Your AI agent needs to read and act in your customers' Paychex. Use a pre-built, hosted MCP server instead of writing integration code. [Try free](https://mcphub.getknit.dev/) Knit's Unified API connects to 190+ apps across HRIS, ATS, CRM, accounting and more. Knit never stores your end users' data and is SOC 2, GDPR and ISO 27001 compliant: [How Knit handles security](/security/) · [Security Center](https://compliance.getknit.dev/) Not sure which fits? [Talk to a human](/book-demo/) ![](https://storage.googleapis.com/knit-website-media/2026/08/64c34c8eb1ffc79e7f787ecd_Akshat-3-112x112.png)Written by Akshat Jain Coding chaos into innovation and building from zero to scale Keep Reading ------------ ![Payroll API Integration: Developer Guide to ADP, Gusto, Rippling & Paychex(2026)](https://storage.googleapis.com/knit-website-media/2026/08/blog-banner-red-scaled-640x400.png) [Developers](https://getknit.dev/blogs/developers/) ### [Payroll API Integration: Developer Guide to ADP, Gusto, Rippling & Paychex(2026)](https://getknit.dev/blog/payroll-api-integration-developer-guide-to-adp-gusto-rippling-paychex/) Learn how to integrate ADP, Gusto, Rippling, and Paychex payroll APIs — real endpoint paths, authentication setup, rate limit behavior,… April 6, 2026 · 16 min read ![Zoho CRM API Directory: Endpoints, Auth & Rate Limits (2026)](https://storage.googleapis.com/knit-website-media/2026/08/blog-banner-red-scaled-640x400.png) [API Directory](https://getknit.dev/blogs/api-directory/) ### [Zoho CRM API Directory: Endpoints, Auth & Rate Limits (2026)](https://getknit.dev/blog/zoho-crm-api-directory/) Zoho CRM API integration guide covering authentication, bulk read/write, COQL queries, composite requests, backups, and key endpoints. Includes practical highlights… January 31, 2026 · 25 min read ![Zendesk CRM API Directory](https://storage.googleapis.com/knit-website-media/2026/08/blog-banner-yellow-scaled-640x400.png) [API Directory](https://getknit.dev/blogs/api-directory/) ### [Zendesk CRM API Directory](https://getknit.dev/blog/zendesk-crm-api-directory/) Zendesk CRM API integration guide covering key features, endpoints, use cases, FAQs, and best practices to automate customer data, sales… January 31, 2026 · 5 min read \#1 in Ease of Integrations --------------------------- ![4.9 out of 5 stars](/wp-content/themes/knit/assets/images/g2/g2-star-rating.svg) 4.9 out of 5 stars on G2 ![G2 Leader, Spring 2026](/wp-content/themes/knit/assets/images/g2/g2-leader.svg)![G2 Fastest Implementation, Spring 2026](/wp-content/themes/knit/assets/images/g2/g2-fastest-implementation.svg)![G2 High Performer, Spring 2026](/wp-content/themes/knit/assets/images/g2/g2-high-performer.svg)![G2 Best Est. ROI, Spring 2026](/wp-content/themes/knit/assets/images/g2/g2-best-roi.svg) Put Integrations on Autopilot. Talk to Experts. ----------------------------------------------- Knit is loved by customers across the globe due to our seamless product and white glove support. You'll love us too! [Talk to a Human](/book-demo)