Sign in

v1

latestOpenAPI 3.1.02026-07-243113441.2 MB
Salary Estimates

Create a salary estimate for an employee

Create a salary estimate for an employee. This endpoint helps calculate a reasonable salary for S Corp owners based on their occupation, experience level, location, and business revenue.

A salary estimate must include:

  • Annual net revenue of the business
  • ZIP code for location-based salary data
  • One or more occupations with experience levels and time percentages (must sum to 100%)

Only one in-progress salary estimate can exist per employee at a time. If an in-progress estimate already exists, you must either accept it or use the update endpoint.

scope: salary_estimates:write

post/v1/employees/{employee_id}/salary_estimates

Path parameters

employee_idstring required

The UUID of the employee

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

annual_net_revenuenumber nullable

The annual net revenue of the business (must be greater than 0)

zip_codestring required

The ZIP code for location-based salary calculations

Example request

{
  "annual_net_revenue": 500000,
  "zip_code": "94107",
  "occupations": [
    {
      "code": "151252",
      "experience_level": "skilled",
      "time_percentage": "1.0",
      "primary": true
    }
  ]
}

Response

successfully created

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.