---
title: "Calculate gross up for a payroll"
method: POST
path: "/v1/payrolls/{payroll_uuid}/gross_up"
tags: ["Payrolls"]
---

# Calculate gross up for a payroll

`POST /v1/payrolls/{payroll_uuid}/gross_up`

Calculates gross up earnings for an employee's payroll, given net earnings. This endpoint is only applicable to off-cycle unprocessed payrolls.

The gross up amount must then be mapped to the corresponding fixed compensation earning type to get the correct payroll amount. For example, for bonus off-cycles, the gross up amount should be set with the Bonus earning type in the payroll `fixed_compensations` field.

scope: `payrolls:run`

## Path parameters

- `payroll_uuid` string, required

## Headers

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

## Request body

- PayrollGrossUpRequest — Request body for calculating gross up amount
  - `employee_uuid` string, required — The UUID of the employee
  - `net_pay` string, float, required — Employee net earnings

## Response `200`

Successful

- PayrollGrossUpResponse — Response containing the calculated gross up amount
  - `gross_up` string, float — Gross up earnings.

## 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.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)