---
title: "Skip a payroll"
method: POST
path: "/v1/companies/{company_uuid}/payrolls/skip"
tags: ["Payrolls"]
---

# Skip a payroll

`POST /v1/companies/{company_uuid}/payrolls/skip`

Submits a $0 payroll for employees associated with the pay schedule to skip payroll. This submission is asynchronous and a successful request responds with a 202 HTTP status. Upon success, the payroll is transitioned to the `processed` state.

If the company is blocked from running payroll due to issues like incomplete setup, missing information or other compliance issues, the response will be 422 Unprocessable Entity with a categorization of the blockers as described in the error responses.

scope: `payrolls:run`

## Path parameters

- `company_uuid` string, required

## Headers

- `X-Gusto-API-Version` '2026-06-15'

## Request body

- object
  - `payroll_type` 'Regular' | 'Hired employee' | 'Dismissed employee' | 'Transition from old pay schedule', required — Payroll type
  - `start_date` string — Pay period start date
  - `end_date` string — Pay period end date. If left empty, defaults to today's date. Required when skipping a termination payroll (`payroll_type` = `Dismissed employee`).
  - `pay_schedule_uuid` string — The UUID of the pay schedule. Required when skipping a termination payroll (`payroll_type` = `Dismissed employee`).
  - `employee_uuids` string[], nullable — An array of employees. This field is only applicable to new hire payroll and termination payroll

## Response `202`

Accepted

## Other responses

- `404` — Not Found The requested resource does not exist. Make sure the provided UUID is valid.
- `422` — Unprocessable Entity This may happen when the body of your request contains errors such as `invalid_attribute_value`, or the request fails due to an `invalid_operation`. See the [Errors Categories](https://docs.gusto.com/embedded-payroll/docs/error-categories) guide for more details.

---

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