---
title: "Submit payroll"
method: PUT
path: "/v1/companies/{company_id}/payrolls/{payroll_id}/submit"
tags: ["Payrolls"]
---

# Submit payroll

`PUT /v1/companies/{company_id}/payrolls/{payroll_id}/submit`

## Request

- Base URL: `https://api.gusto-demo.com`
- URL: `https://api.gusto-demo.com/v1/companies/{company_id}/payrolls/{payroll_id}/submit`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/gusto/apis/gusto-api/docs/v1/companies/:company_id/payrolls/:payroll_id/submit/put.ts> (a function with typed inputs; its response is checked against the schema)

Submits an unprocessed payroll to be calculated and run. This submission is asynchronous and a successful request responds with a 202 HTTP status. Upon success, transitions the payroll to the `processed` state.

You should poll to ensure that payroll is processed successfully, as async errors only occur after async processing is complete.

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_id` string, required
- `payroll_id` string, required

## Headers

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

## Request body

- object
  - `submission_blockers` PayrollSubmissionBlockerRequestType[]: An array of submission_blockers, each with a selected unblock option.
    - `blocker_type` string, required: The type of submission_blocker that is blocking the payment.
    - `selected_option` string, required: The selected option to unblock the payment's submission_blocker.

## Response `202`

Accepted

## Other responses

- `404`: Not Found
- `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.dev/gusto/apis/gusto-api.md) - [All operations](https://skmtc.dev/gusto/apis/gusto-api/llms.txt) - [OpenAPI document](https://skmtc.dev/gusto/apis/gusto-api/revisions/f98575fa2a5e?raw)