GuidesAPI ReferenceChangelogAPI StatusAPI PolicyGusto Security
API Reference

Create a salary estimate for an employee

post
https://api.gusto-demo.com/v1/employees//salary_estimates

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

Path Params
string
required

The UUID of the employee

Body Params
number | null

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

string
required

The ZIP code for location-based salary calculations

occupations
array of objects
required
length ≥ 1

Array of occupations. Time percentages must sum to 100%.

occupations*
string
required

Bureau of Labor Statistics (BLS) occupation code

string
enum
required

Experience level for this occupation

Allowed:
string
required
0 to 1

Percentage of time spent in this occupation (as decimal, e.g., 1.0 = 100%)

boolean

Whether this is the primary occupation

Headers
string
enum
Defaults to 2026-02-01

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

Allowed:
Responses

Updated 5 months ago

Language
Credentials
Bearer
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated 5 months ago