Update payroll draft

Fully replace an existing draft payroll with a new employee/contractor payload. This follows the same request contract as create draft and returns the same preview payload shape.

Flow: POST /payrolls (create draft) → PATCH /payrolls/:id (replace draft contents) → review preview → approve.

Only available for payrolls in draft status. Requires the payroll plan or higher.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
string
required

Unique payroll identifier (e.g. pay_abc123def456)

Body Params

Full-replace request body for updating an existing draft payroll. Uses the same shape and validation rules as create draft.

string
enum
required
Allowed:
string
required

Pay period start date (YYYY-MM-DD)

string
required

Pay period end date (YYYY-MM-DD)

string
required

Payday (YYYY-MM-DD)

string | null
enum

Required for type=regular

Allowed:
integer | null

Required for type=regular

employees
array of objects

Employee payroll entries

employees
contractors
array of objects

Contractor payroll entries

contractors
Responses

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json