---
title: "Bulk create pay stubs"
method: POST
path: "/pay_stubs/bulk/create"
tags: ["Pay Stubs"]
---

# Bulk create pay stubs

`POST /pay_stubs/bulk/create`

Bulk-create pay stubs under the given payroll, one for each selected work assignment on the payroll's pay schedule. Work assignments that already have a pay stub on the payroll are skipped. The payroll must be a once-off, historical, correction, or custom-schedule payroll in `draft` status - the same payrolls that accept manual pay stub creation.

## Request body

- object
  - `payroll_id` string, required — The payroll to create the pay stubs under.
  - `work_assignments` object, required — The work assignment selection criteria. `work_assignments.include` must be either the string `"all"`, or an object containing one or more of `ids` (string array), `payee_type` (`employee` or `contractor`), `pay_schedule_id`, `archived` (boolean), `payee_names` (string). `work_assignments.exclude` (optional) is an object containing one or more of the same keys.
    - `exclude` object
      - `ids` string[]
      - `payee_type` 'contractor' | 'employee'
      - `pay_schedule_id` string
      - `archived` boolean
      - `payee_names` string

## Response `202`

Accepted

---

[API](https://skmtc.net/nmbr/apis/nmbr-api.md) · [All operations](https://skmtc.net/nmbr/apis/nmbr-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/nmbr/nmbr-api/revisions/01cd9c45a923/schema)