# Pull your Paychex Flex payroll journals into your systems

> Read the Payroll Journal from Analytics & Reports in Paychex Flex with one API call, for a date range and one or all employees. Or have a workflow pick up each new check date and post every check's earnings, taxes and deductions to your accounting system.

Page: https://fous.com/automate/paychex-flex
Updated: 2026-11-12

Works with your own Paychex Flex account. Fous is an independent product.

## What you can build on Paychex Flex

### Get the Payroll Journal

Runs the Payroll Journal from Analytics & Reports, View All Reports, for the date range and employee you give, and reads each check on it.

- Takes: Date range, employee or All Employees
- Returns: Employee, check date, pay period, earnings by type, employee taxes, employer taxes, deductions, net pay

### Get year-to-date payroll totals

Runs the Payroll Journal with Date Range set to Current Year and All Employees, and totals it per employee.

- Takes: Nothing
- Returns: Employee, gross wages, employee taxes, employer taxes, deductions, net pay, number of checks

### List requests waiting in Integrated Apps

Reads Integrated Apps in Paychex Flex and lists the apps that have asked for access to your company and wait for Approve or Deny.

- Takes: Nothing
- Returns: App name, status

### Approve or deny an app in Integrated Apps

Opens Integrated Apps, finds the app you name and selects Approve or Deny for its access request.

- Takes: App name, approve or deny
- Returns: App name, status

## Automate Paychex Flex with a workflow

A [workflow](/product/workflows) runs your methods as one process, with nobody at the screen. A schedule or a call from your own system starts it, the steps run in order, and the result arrives in your inbox or in the systems you already use.

### Each new payroll's journal, posted to accounting

Starts: Every weekday at 8:00

1. Get the Payroll Journal for the last 14 days and All Employees.
2. Keep the check dates that were not there on the last run.
3. Post each check's earnings, taxes, deductions and net pay to your accounting webhook.

### Monthly year-to-date payroll summary

Starts: Monthly on the 1st at 7:00

1. Get the year-to-date payroll totals from the Payroll Journal for Current Year.
2. Summarize gross wages, employer taxes and net pay, and what changed since last month.
3. Email you the summary with the per-employee totals.

### New app access requests in Integrated Apps

Starts: Every weekday at 9:00

1. List the apps waiting for Approve or Deny in Integrated Apps.
2. Keep the requests that were not there on the last run.
3. Email you each new request with the app name.

You can run a workflow by hand on every plan, Free included. Schedules and webhook triggers come with the paid plans, from $29 a month.

## Once built, one call from your code

Once you have built a [method](/product/methods), it is one POST to /v1/runs from your backend, or a tool an AI agent calls over MCP. This is what “Get the Payroll Journal” would look like.

Example request:

```
curl https://api.fous.com/v1/runs \
  -H "Authorization: Bearer $FOUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "method": "myapps.paychex.com/get_payroll_journal",
    "input": {
      "date_from": "2026-10-26",
      "date_to": "2026-11-08",
      "employee": "All Employees"
    }
  }'
```

Example response:

```
{
  "status": "completed",
  "data": {
    "company": "Acme Supply Co",
    "checks": [
      {
        "employee": "Employee 0042",
        "check_date": "2026-11-07",
        "pay_period": "2026-10-19 to 2026-11-01",
        "earnings": {
          "hourly": 2236
        },
        "employee_taxes": {
          "federal": 214.5,
          "fica": 171.05
        },
        "employer_taxes": {
          "fica": 171.05,
          "futa": 13.42
        },
        "deductions": {
          "401k": 111.8,
          "medical": 64
        },
        "net_pay": 1674.65
      }
    ]
  }
}
```

An example with invented data, not a ready-made endpoint. The method exists in your organization once you build it, and its name, inputs and fields follow your request.

## Paychex Flex’s own options

Paychex has a public API with Company, Payroll, Worker, Webhooks and Management sections. A client can create its own app inside Paychex Flex if a user has permission to manage connected applications. Software vendors go through Paychex's partner process, and each client approves the connection in Integrated Apps.

| Option | What it covers | What it takes |
| --- | --- | --- |
| API app created by a client | Paychex's public API for your own company, and for other client IDs linked to the app as Child accounts. | A Paychex Flex user allowed to manage connected applications, such as a Super Admin or a Security Admin. |
| Partner application | The same API for a vendor serving many Paychex clients, with the endpoints requested for production. | A questionnaire, review by the Corporate Partnerships Team, a sandbox build, a demo, and each client's approval in Integrated Apps. |
| Webhooks | Notifications to a registered app, such as CLT_ACCESS when a client accepts a partner integration. | A production app registered for the webhook. |
| Paychex Flex by hand | Analytics & Reports, where reports such as the Payroll Journal are run for a date range and downloaded. | A Paychex Flex sign-in with access to the reports. |

Read on November 12, 2026: [Paychex API Developer Center: process for clients](https://developer.paychex.com/client), [Paychex API Developer Center: process for partners](https://developer.paychex.com/partner), [Paychex API documentation](https://developer.paychex.com/documentation).

## Signing in to Paychex Flex

Paychex Flex signs people in at login.flex.paychex.com, which asks for the username on its own first screen. With Fous, you sign in once through that page with your own Paychex Flex account. The login is sealed with AES-256 and never returned by the API or written to logs, and a method reads and does only what your account can.

## Worth knowing

- **Who can create an API app**: Creating an app in Paychex Flex needs permission to manage connected applications, which roles such as Super Admin and Security Admin have.
- **Several client IDs, one app**: Paychex suggests choosing one client account to manage the integration on, the Parent account, and linking other client accounts to the app as Child accounts.
- **Vendors wait for client approval**: A partner sends Request Client Access with the client's 8-digit displayId. The client then signs in to Paychex Flex and selects Approve or Deny under Integrated Apps, one client at a time.
- **The Payroll Journal takes two parameters**: The Payroll Journal under Analytics & Reports is run for a Date Range and an employee parameter. A full-year pull uses Current Year and All Employees.

## More in HR: payroll, hiring and screening

- [The Work Number](https://fous.com/automate/the-work-number.md)
- [Workday](https://fous.com/automate/workday.md)
- [Indeed for Employers](https://fous.com/automate/indeed-for-employers.md)
- [SEEK Employer](https://fous.com/automate/seek-employer.md)
- [Paycom](https://fous.com/automate/paycom.md)
- [Paylocity](https://fous.com/automate/paylocity.md)
- [ADP Workforce Now](https://fous.com/automate/adp-workforce-now.md)
- [Silae](https://fous.com/automate/silae.md)
- [RUN Powered by ADP](https://fous.com/automate/run-powered-by-adp.md)
- [Gusto](https://fous.com/automate/gusto.md)

Other industries: [SOKA-BAU Online-Service](/automate/soka-bau-online-service), [NuORDER](/automate/nuorder), [Walmart Seller Center](/automate/walmart-seller-center), [AQA Centre Services](/automate/aqa-centre-services), [DTE Energy online account](/automate/dte-energy-online-account), [METRO Online-Kundenkonto](/automate/metro-online-kundenkonto).

## Frequently asked questions

### Does Paychex Flex have an API?

Yes. Paychex publishes an API with Company, Payroll, Worker, Webhooks and Management sections. A client user who can manage connected applications creates an app in Paychex Flex, and vendors apply through Paychex's partner process, with each client approving in Integrated Apps.

### Can an accountant reach several Paychex clients through one app?

Through Paychex's own API, yes, in two ways: a client app can link other client IDs as Child accounts, and an approved partner app is linked to each client after that client approves it in Integrated Apps.

### Where is the Payroll Journal in Paychex Flex?

Under Analytics & Reports, then View All Reports, then Payroll Journal. You set the Date Range and the employee parameter, run the report and download it.

### How does a partner app get access to a client?

The partner calls Request Client Access with the client's 8-digit displayId, which puts the app in that client's Integrated Apps. The client signs in to Paychex Flex and approves or denies it there, and the partner can listen for the CLT_ACCESS webhook.

### Is Fous affiliated with Paychex?

No. Fous is an independent product. It works through your own Paychex Flex account, and a method reads and does only what that account can.

Fous is an independent product: it is not affiliated with, endorsed by or sponsored by the operator of Paychex Flex (Paychex). The name is used only to say which system this page is about. Something here wrong or out of date? Write to legal@fous.com.
