---
title: "Bulk create work assignments"
method: POST
path: "/work_assignments/bulk/create"
tags: ["Work Assignments"]
---

# Bulk create work assignments

`POST /work_assignments/bulk/create`

Bulk-create work assignments for the selected payees (employees and contractors) on the target pay schedule. Payees that already have a work assignment on that pay schedule are skipped.

## Request body

- object
  - `data` object — The properties for each new work assignment, including the required `pay_schedule_id`. Accepts the same fields as creating a single work assignment.
    - `pay_schedule_id` string
  - `payees` object, required — The payee selection criteria. `payees.include` must be either the string `"all"`, or an object containing one or more of `ids` (string array of employee/contractor ids), `payee_type` (`employee` or `contractor`), `payee_names` (string), `archived` (boolean). `payees.exclude` (optional) is an object containing one or more of the same keys. Must be present when `payees.include.payee_type`, `payees.include.payee_names` and `payees.include.archived` is either empty or not set. Must be present when `payees.include.ids`, `payees.include.payee_names` and `payees.include.archived` is either empty or not set. Must be present when `payees.include.ids`, `payees.include.payee_type` and `payees.include.archived` is either empty or not set. Must be present when `payees.include.ids`, `payees.include.payee_type` and `payees.include.payee_names` is either empty or not set.
    - `include` object — Must be present when `payees.include.payee_type`, `payees.include.payee_names` and `payees.include.archived` is either empty or not set. Must be present when `payees.include.ids`, `payees.include.payee_names` and `payees.include.archived` is either empty or not set. Must be present when `payees.include.ids`, `payees.include.payee_type` and `payees.include.archived` is either empty or not set. Must be present when `payees.include.ids`, `payees.include.payee_type` and `payees.include.payee_names` is either empty or not set.
      - `ids` string[] — Must be present when `payees.include.payee_type`, `payees.include.payee_names` and `payees.include.archived` is either empty or not set.
      - `payee_type` 'contractor' | 'employee' — Must be present when `payees.include.ids`, `payees.include.payee_names` and `payees.include.archived` is either empty or not set.
      - `payee_names` string — Must be present when `payees.include.ids`, `payees.include.payee_type` and `payees.include.archived` is either empty or not set.
      - `archived` boolean — Must be present when `payees.include.ids`, `payees.include.payee_type` and `payees.include.payee_names` is either empty or not set.
    - `exclude` object
      - `ids` string[]
      - `payee_type` 'contractor' | 'employee'
      - `payee_names` string
      - `archived` boolean

## 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/c2532d856ea2/schema)