Pull your Paychex Flex payroll journals into your systems

What you can build on Paychex Flex

• Get the Payroll Journal

  Build this

  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

  Build this

  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

  Build this

  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

  Build this

  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 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

  Build this

  Starts

  Every weekday at 8:00

  Step 1

  Get the Payroll Journal for the last 14 days and All Employees.

  Step 2

  Keep the check dates that were not there on the last run.

  Step 3

  Post each check's earnings, taxes, deductions and net pay to your accounting webhook.

• Monthly year-to-date payroll summary

  Build this

  Starts

  Monthly on the 1st at 7:00

  Step 1

  Get the year-to-date payroll totals from the Payroll Journal for Current Year.

  Step 2

  Summarize gross wages, employer taxes and net pay, and what changed since last month.

  Step 3

  Email you the summary with the per-employee totals.

• New app access requests in Integrated Apps

  Build this

  Starts

  Every weekday at 9:00

  Step 1

  List the apps waiting for Approve or Deny in Integrated Apps.

  Step 2

  Keep the requests that were not there on the last run.

  Step 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, 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.

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"
    }
  }'

{
  "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.

Read on November 12, 2026: Paychex API Developer Center: process for clients, Paychex API Developer Center: process for partners, Paychex API 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
• Workday
• Indeed for Employers
• SEEK Employer
• Paycom
• Paylocity
• ADP Workforce Now
• Silae
• RUN Powered by ADP
• Gusto

Other industries: SOKA-BAU Online-Service, NuORDER, Walmart Seller Center, AQA Centre Services, DTE Energy online account, METRO Online-Kundenkonto.