v1

latestOpenAPI 3.1.02026-07-243113441.2 MB

Salary Estimates

Accept a salary estimate

Accept and finalize a salary estimate. This associates the estimate with an employee job and marks it as accepted.

Once accepted, the salary estimate becomes read-only for record-keeping purposes. The accepted salary can then be used to set up compensation for the employee.

scope: salary_estimates:write

post/v1/salary_estimates/{uuid}/accept

Path parameters

uuidstring required

The UUID of the salary estimate

Headers

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

Determines the date-based API version associated with your API call. If none is provided, your application's minimum API version is used.

Request body

employee_job_uuidstring required

The UUID of the employee job to associate with this salary estimate

Example request

{
  "employee_job_uuid": "7f5d3d93-6d6f-48c0-9f4e-cd12c2d3e4b2"
}

Response

successful

uuidstring required

The UUID of the salary estimate.

employee_uuidstring nullable required

The UUID of the employee this salary estimate is for.

employee_job_uuidstring nullable

The UUID of the employee job this salary estimate is associated with (once accepted).

annual_net_revenuestring nullable required

The annual net revenue of the business used for salary calculations.

zip_codestring nullable required

The ZIP code used for location-based salary calculations.

resultinteger nullable

The calculated reasonable salary estimate in cents. Null if not yet calculated.

accepted_atstring date-time nullable

The timestamp when this salary estimate was accepted and finalized.

created_atstring date-time required

The timestamp when this salary estimate was created.

updated_atstring date-time required

The timestamp when this salary estimate was last updated.