# Gusto API API

> Gusto API API on Apizie: 100 endpoints (Get info about the current access token, Refresh access token, Create a company, Get a company, …) returned as clean JSON through one API key. Send your own provider key in the x-upstream-key header. Call it over REST at https://apizie.tech/v1/finance:gusto-app-integrations/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month.

- Project key: `finance:gusto-app-integrations`
- Category: Finance
- Status: byok
- Source: https://gusto.com
- Page: https://apizie.tech/api/finance/gusto-app-integrations
- OpenAPI: https://apizie.tech/api/finance/gusto-app-integrations/openapi.json

Welcome to Gusto's Embedded Payroll API documentation!

## Endpoints

### Get info about the current access token
`GET https://apizie.tech/v1/finance:gusto-app-integrations/introspection-access-token-info` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-Gusto-API-Version | string | no | Determines the date-based API version associated with your API call. If none is provided, your application's [minimum API… |

### Refresh access token
`POST https://apizie.tech/v1/finance:gusto-app-integrations/introspection-exchange-refresh-token` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-Gusto-API-Version | string | no | Determines the date-based API version associated with your API call. If none is provided, your application's [minimum API… |
| body | object | no | JSON request body |

### Create a company
`POST https://apizie.tech/v1/finance:gusto-app-integrations/companies-create-company` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-Gusto-API-Version | string | no | Determines the date-based API version associated with your API call. If none is provided, your application's [minimum API… |
| body | object | no | JSON request body |

### Get a company
`GET https://apizie.tech/v1/finance:gusto-app-integrations/companies-get-company-info` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| company_id | string | yes | The UUID of the company |
| X-Gusto-API-Version | string | no | Determines the date-based API version associated with your API call. If none is provided, your application's [minimum API… |

### Get the custom fields of a company
`GET https://apizie.tech/v1/finance:gusto-app-integrations/companies-get-custom-fields` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| company_id | string | yes | The UUID of the company |
| page | number | no | The page that is requested. When unspecified, will load all objects unless endpoint forces pagination. |
| per | number | no | Number of objects per page. For majority of endpoints will default to 25 |
| X-Gusto-API-Version | string | no | Determines the date-based API version associated with your API call. If none is provided, your application's [minimum API… |

### Get company locations
`GET https://apizie.tech/v1/finance:gusto-app-integrations/locations-list-company-locations` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| company_id | string | yes | The UUID of the company |
| page | number | no | The page that is requested. When unspecified, will load all objects unless endpoint forces pagination. |
| per | number | no | Number of objects per page. For majority of endpoints will default to 25 |
| X-Gusto-API-Version | string | no | Determines the date-based API version associated with your API call. If none is provided, your application's [minimum API… |

### Create a company location
`POST https://apizie.tech/v1/finance:gusto-app-integrations/locations-create-company-location` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| company_id | string | yes | The UUID of the company |
| X-Gusto-API-Version | string | no | Determines the date-based API version associated with your API call. If none is provided, your application's [minimum API… |
| body | object | no | JSON request body |

### Get a location
`GET https://apizie.tech/v1/finance:gusto-app-integrations/locations-get-details` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| location_id | string | yes | The UUID of the location |
| X-Gusto-API-Version | string | no | Determines the date-based API version associated with your API call. If none is provided, your application's [minimum API… |

### Update a location
`POST https://apizie.tech/v1/finance:gusto-app-integrations/locations-update-location` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| location_id | string | yes | The UUID of the location |
| X-Gusto-API-Version | string | no | Determines the date-based API version associated with your API call. If none is provided, your application's [minimum API… |
| body | object | no | JSON request body |

### Get minimum wages for a location
`GET https://apizie.tech/v1/finance:gusto-app-integrations/locations-get-minimum-wages` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| location_uuid | string | yes | The UUID of the location |
| effective_date | string | no |  |
| X-Gusto-API-Version | string | no | Determines the date-based API version associated with your API call. If none is provided, your application's [minimum API… |

### Get the pay schedules for a company
`GET https://apizie.tech/v1/finance:gusto-app-integrations/pay-schedules-list` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| company_id | string | yes | The UUID of the company |
| page | number | no | The page that is requested. When unspecified, will load all objects unless endpoint forces pagination. |
| per | number | no | Number of objects per page. For majority of endpoints will default to 25 |
| X-Gusto-API-Version | string | no | Determines the date-based API version associated with your API call. If none is provided, your application's [minimum API… |

### Get a pay schedule
`GET https://apizie.tech/v1/finance:gusto-app-integrations/pay-schedules-get-details` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| company_id | string | yes | The UUID of the company |
| pay_schedule_id | string | yes | The UUID of the pay schedule |
| X-Gusto-API-Version | string | no | Determines the date-based API version associated with your API call. If none is provided, your application's [minimum API… |

### Get pay periods for a company
`GET https://apizie.tech/v1/finance:gusto-app-integrations/pay-schedules-list-2` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| company_id | string | yes | The UUID of the company |
| start_date | string | no |  |
| end_date | string | no |  |
| payroll_types | string | no | regular and/or transition. Multiple options are comma separated. The default is regular pay periods if nothing is passed in. |
| X-Gusto-API-Version | string | no | Determines the date-based API version associated with your API call. If none is provided, your application's [minimum API… |

### Get termination pay periods for a company
`GET https://apizie.tech/v1/finance:gusto-app-integrations/pay-schedules-list-unprocessed-termination-pay-periods` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| company_id | string | yes | The UUID of the company |
| X-Gusto-API-Version | string | no | Determines the date-based API version associated with your API call. If none is provided, your application's [minimum API… |

### Get pay schedule assignments for a company
`GET https://apizie.tech/v1/finance:gusto-app-integrations/pay-schedules-get-assignments` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| company_id | string | yes | The UUID of the company |
| X-Gusto-API-Version | string | no | Determines the date-based API version associated with your API call. If none is provided, your application's [minimum API… |

### Get employees of a company
`GET https://apizie.tech/v1/finance:gusto-app-integrations/employees-get-company-employees` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| company_id | string | yes | The UUID of the company |
| terminated | boolean | no | Filters employees by the provided boolean |
| include | string | no | Include the requested attribute(s) in each employee response, multiple options are comma separated. Available options: -… |
| page | number | no | The page that is requested. When unspecified, will load all objects unless endpoint forces pagination. |
| per | number | no | Number of objects per page. For majority of endpoints will default to 25 |
| X-Gusto-API-Version | string | no | Determines the date-based API version associated with your API call. If none is provided, your application's [minimum API… |

### Create an employee
`POST https://apizie.tech/v1/finance:gusto-app-integrations/employees-create-employee` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| company_id | string | yes | The UUID of the company |
| X-Gusto-API-Version | string | no | Determines the date-based API version associated with your API call. If none is provided, your application's [minimum API… |
| body | object | no | JSON request body |

### Get all departments of a company
`GET https://apizie.tech/v1/finance:gusto-app-integrations/departments-list-for-company` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| company_uuid | string | yes | The UUID of the company |
| X-Gusto-API-Version | string | no | Determines the date-based API version associated with your API call. If none is provided, your application's [minimum API… |

### Create a department
`POST https://apizie.tech/v1/finance:gusto-app-integrations/departments-create-department` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| company_uuid | string | yes | The UUID of the company |
| X-Gusto-API-Version | string | no | Determines the date-based API version associated with your API call. If none is provided, your application's [minimum API… |
| body | object | no | JSON request body |

### Get a department
`GET https://apizie.tech/v1/finance:gusto-app-integrations/departments-get-by-uuid` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| department_uuid | string | yes | The UUID of the department |
| X-Gusto-API-Version | string | no | Determines the date-based API version associated with your API call. If none is provided, your application's [minimum API… |

### Update a department
`POST https://apizie.tech/v1/finance:gusto-app-integrations/departments-update-department` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| department_uuid | string | yes | The UUID of the department |
| X-Gusto-API-Version | string | no | Determines the date-based API version associated with your API call. If none is provided, your application's [minimum API… |
| body | object | no | JSON request body |

### Delete a department
`POST https://apizie.tech/v1/finance:gusto-app-integrations/departments-delete-department` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| department_uuid | string | yes | The UUID of the department |
| X-Gusto-API-Version | string | no | Determines the date-based API version associated with your API call. If none is provided, your application's [minimum API… |

### Add people to a department
`POST https://apizie.tech/v1/finance:gusto-app-integrations/departments-add-people-to-department` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| department_uuid | string | yes | The UUID of the department |
| X-Gusto-API-Version | string | no | Determines the date-based API version associated with your API call. If none is provided, your application's [minimum API… |
| body | object | no | JSON request body |

### Remove people from a department
`POST https://apizie.tech/v1/finance:gusto-app-integrations/departments-remove-employees` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| department_uuid | string | yes | The UUID of the department |
| X-Gusto-API-Version | string | no | Determines the date-based API version associated with your API call. If none is provided, your application's [minimum API… |
| body | object | no | JSON request body |

### Get an employee
`GET https://apizie.tech/v1/finance:gusto-app-integrations/employees-get-details` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| employee_id | string | yes | The UUID of the employee |
| include | string | no | Include the requested attribute(s) in each employee response, multiple options are comma separated. Available options: -… |
| X-Gusto-API-Version | string | no | Determines the date-based API version associated with your API call. If none is provided, your application's [minimum API… |

### Update an employee
`POST https://apizie.tech/v1/finance:gusto-app-integrations/employees-update-employee` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| employee_id | string | yes | The UUID of the employee |
| X-Gusto-API-Version | string | no | Determines the date-based API version associated with your API call. If none is provided, your application's [minimum API… |
| body | object | no | JSON request body |

### Delete an onboarding employee
`POST https://apizie.tech/v1/finance:gusto-app-integrations/employees-delete-onboarding-employee` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| employee_id | string | yes | The UUID of the employee |
| X-Gusto-API-Version | string | no | Determines the date-based API version associated with your API call. If none is provided, your application's [minimum API… |

### Get terminations for an employee
`GET https://apizie.tech/v1/finance:gusto-app-integrations/employee-employments-list-terminations-for-employee` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| employee_id | string | yes | The UUID of the employee |
| X-Gusto-API-Version | string | no | Determines the date-based API version associated with your API call. If none is provided, your application's [minimum API… |

### Create an employee termination
`POST https://apizie.tech/v1/finance:gusto-app-integrations/employee-employments-create-termination` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| employee_id | string | yes | The UUID of the employee |
| X-Gusto-API-Version | string | no | Determines the date-based API version associated with your API call. If none is provided, your application's [minimum API… |
| body | object | no | JSON request body |

### Delete an employee termination
`POST https://apizie.tech/v1/finance:gusto-app-integrations/employee-employments-delete-termination` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| employee_id | string | yes | The UUID of the employee |
| X-Gusto-API-Version | string | no | Determines the date-based API version associated with your API call. If none is provided, your application's [minimum API… |

### Update an employee termination
`POST https://apizie.tech/v1/finance:gusto-app-integrations/employee-employments-update-termination` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| employee_id | string | yes | The UUID of the employee |
| X-Gusto-API-Version | string | no | Determines the date-based API version associated with your API call. If none is provided, your application's [minimum API… |
| body | object | no | JSON request body |

### Get an employee rehire
`GET https://apizie.tech/v1/finance:gusto-app-integrations/employee-employments-get-rehire-info` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| employee_id | string | yes | The UUID of the employee |
| X-Gusto-API-Version | string | no | Determines the date-based API version associated with your API call. If none is provided, your application's [minimum API… |

### Create an employee rehire
`POST https://apizie.tech/v1/finance:gusto-app-integrations/employee-employments-create-rehire` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| employee_id | string | yes | The UUID of the employee |
| X-Gusto-API-Version | string | no | Determines the date-based API version associated with your API call. If none is provided, your application's [minimum API… |
| body | object | no | JSON request body |

### Update an employee rehire
`POST https://apizie.tech/v1/finance:gusto-app-integrations/employee-employments-update-rehire` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| employee_id | string | yes | The UUID of the employee |
| X-Gusto-API-Version | string | no | Determines the date-based API version associated with your API call. If none is provided, your application's [minimum API… |
| body | object | no | JSON request body |

### Delete an employee rehire
`POST https://apizie.tech/v1/finance:gusto-app-integrations/employee-employments-delete-rehire` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| employee_id | string | yes | The UUID of the employee |
| X-Gusto-API-Version | string | no | Determines the date-based API version associated with your API call. If none is provided, your application's [minimum API… |

### Get employment history for an employee
`GET https://apizie.tech/v1/finance:gusto-app-integrations/employee-employments-get-history` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| employee_id | string | yes | The UUID of the employee |
| X-Gusto-API-Version | string | no | Determines the date-based API version associated with your API call. If none is provided, your application's [minimum API… |

### Get an employee's home addresses
`GET https://apizie.tech/v1/finance:gusto-app-integrations/employee-addresses-get-home-addresses` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| employee_id | string | yes | The UUID of the employee |
| X-Gusto-API-Version | string | no | Determines the date-based API version associated with your API call. If none is provided, your application's [minimum API… |

### Create an employee's home address
`POST https://apizie.tech/v1/finance:gusto-app-integrations/employee-addresses-create-home-address` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| employee_id | string | yes | The UUID of the employee |
| X-Gusto-API-Version | string | no | Determines the date-based API version associated with your API call. If none is provided, your application's [minimum API… |
| body | object | no | JSON request body |

### Get an employee's home address
`GET https://apizie.tech/v1/finance:gusto-app-integrations/employee-addresses-get-home-address` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| home_address_uuid | string | yes | The UUID of the home address |
| X-Gusto-API-Version | string | no | Determines the date-based API version associated with your API call. If none is provided, your application's [minimum API… |

### Update an employee's home address
`POST https://apizie.tech/v1/finance:gusto-app-integrations/employee-addresses-update-home-address` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| home_address_uuid | string | yes | The UUID of the home address |
| X-Gusto-API-Version | string | no | Determines the date-based API version associated with your API call. If none is provided, your application's [minimum API… |
| body | object | no | JSON request body |

### Delete an employee's home address
`POST https://apizie.tech/v1/finance:gusto-app-integrations/employee-addresses-delete-employee-home-address` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| home_address_uuid | string | yes | The UUID of the home address |
| X-Gusto-API-Version | string | no | Determines the date-based API version associated with your API call. If none is provided, your application's [minimum API… |

### Get an employee's work addresses
`GET https://apizie.tech/v1/finance:gusto-app-integrations/employee-addresses-get-work-addresses` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| employee_id | string | yes | The UUID of the employee |
| X-Gusto-API-Version | string | no | Determines the date-based API version associated with your API call. If none is provided, your application's [minimum API… |

### Create an employee work address
`POST https://apizie.tech/v1/finance:gusto-app-integrations/employee-addresses-create-work-address` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| employee_id | string | yes | The UUID of the employee |
| X-Gusto-API-Version | string | no | Determines the date-based API version associated with your API call. If none is provided, your application's [minimum API… |
| body | object | no | JSON request body |

### Get an employee work address
`GET https://apizie.tech/v1/finance:gusto-app-integrations/employee-addresses-get` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| work_address_uuid | string | yes | The UUID of the work address |
| X-Gusto-API-Version | string | no | Determines the date-based API version associated with your API call. If none is provided, your application's [minimum API… |

### Update an employee work address
`POST https://apizie.tech/v1/finance:gusto-app-integrations/employee-addresses-update-work-address` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| work_address_uuid | string | yes | The UUID of the work address |
| X-Gusto-API-Version | string | no | Determines the date-based API version associated with your API call. If none is provided, your application's [minimum API… |
| body | object | no | JSON request body |

### Delete an employee's work address
`POST https://apizie.tech/v1/finance:gusto-app-integrations/employee-addresses-delete-employee-work-address` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| work_address_uuid | string | yes | The UUID of the work address |
| X-Gusto-API-Version | string | no | Determines the date-based API version associated with your API call. If none is provided, your application's [minimum API… |

### Get an employee's custom fields
`GET https://apizie.tech/v1/finance:gusto-app-integrations/employees-get-custom-fields` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| employee_id | string | yes | The UUID of the employee |
| page | number | no | The page that is requested. When unspecified, will load all objects unless endpoint forces pagination. |
| per | number | no | Number of objects per page. For majority of endpoints will default to 25 |
| X-Gusto-API-Version | string | no | Determines the date-based API version associated with your API call. If none is provided, your application's [minimum API… |

### Get jobs for an employee
`GET https://apizie.tech/v1/finance:gusto-app-integrations/jobs-and-compensations-get-employee-jobs` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| employee_id | string | yes | The UUID of the employee |
| page | number | no | The page that is requested. When unspecified, will load all objects unless endpoint forces pagination. |
| per | number | no | Number of objects per page. For majority of endpoints will default to 25 |
| include | string | no | Available options: - all_compensations: Include all effective dated compensations for each job instead of only the current compensation |
| X-Gusto-API-Version | string | no | Determines the date-based API version associated with your API call. If none is provided, your application's [minimum API… |

### Create a job
`POST https://apizie.tech/v1/finance:gusto-app-integrations/jobs-and-compensations-create-job` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| employee_id | string | yes | The UUID of the employee |
| X-Gusto-API-Version | string | no | Determines the date-based API version associated with your API call. If none is provided, your application's [minimum API… |
| body | object | no | JSON request body |

### Get employee time off activities
`GET https://apizie.tech/v1/finance:gusto-app-integrations/employees-get-time-off-activities` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| employee_uuid | string | yes | The UUID of the employee |
| time_off_type | string | yes | The time off type name you want to query data for. ex: 'sick' or 'vacation' |
| X-Gusto-API-Version | string | no | Determines the date-based API version associated with your API call. If none is provided, your application's [minimum API… |

### Get a job
`GET https://apizie.tech/v1/finance:gusto-app-integrations/jobs-and-compensations-get-details` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| job_id | string | yes | The UUID of the job |
| include | string | no | Available options: - all_compensations: Include all effective dated compensations for the job instead of only the current compensation |
| X-Gusto-API-Version | string | no | Determines the date-based API version associated with your API call. If none is provided, your application's [minimum API… |

### Update a job
`POST https://apizie.tech/v1/finance:gusto-app-integrations/jobs-and-compensations-update-job` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| job_id | string | yes | The UUID of the job |
| X-Gusto-API-Version | string | no | Determines the date-based API version associated with your API call. If none is provided, your application's [minimum API… |
| body | object | no | JSON request body |

### Delete an individual job
`POST https://apizie.tech/v1/finance:gusto-app-integrations/jobs-and-compensations-delete-specific-job` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| job_id | string | yes | The UUID of the job |
| X-Gusto-API-Version | string | no | Determines the date-based API version associated with your API call. If none is provided, your application's [minimum API… |

### Get compensations for a job
`GET https://apizie.tech/v1/finance:gusto-app-integrations/jobs-and-compensations-get-compensations-by-job-id` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| job_id | string | yes | The UUID of the job |
| page | number | no | The page that is requested. When unspecified, will load all objects unless endpoint forces pagination. |
| per | number | no | Number of objects per page. For majority of endpoints will default to 25 |
| include | string | no | Available options: - all_compensations: Include all effective dated compensations for each job instead of only the current compensation |
| X-Gusto-API-Version | string | no | Determines the date-based API version associated with your API call. If none is provided, your application's [minimum API… |

### Create a compensation
`POST https://apizie.tech/v1/finance:gusto-app-integrations/jobs-and-compensations-create-compensation` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| job_id | string | yes | The UUID of the job |
| X-Gusto-API-Version | string | no | Determines the date-based API version associated with your API call. If none is provided, your application's [minimum API… |
| body | object | no | JSON request body |

### Get a compensation
`GET https://apizie.tech/v1/finance:gusto-app-integrations/jobs-and-compensations-get-compensation-by-id` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| compensation_id | string | yes | The UUID of the compensation |
| X-Gusto-API-Version | string | no | Determines the date-based API version associated with your API call. If none is provided, your application's [minimum API… |

### Update a compensation
`POST https://apizie.tech/v1/finance:gusto-app-integrations/jobs-and-compensations-update-compensation` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| compensation_id | string | yes | The UUID of the compensation |
| X-Gusto-API-Version | string | no | Determines the date-based API version associated with your API call. If none is provided, your application's [minimum API… |
| body | object | no | JSON request body |

### Delete a compensation
`POST https://apizie.tech/v1/finance:gusto-app-integrations/jobs-and-compensations-delete-compensation` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| compensation_id | string | yes | The UUID of the compensation |
| X-Gusto-API-Version | string | no | Determines the date-based API version associated with your API call. If none is provided, your application's [minimum API… |

### Get all earning types for a company
`GET https://apizie.tech/v1/finance:gusto-app-integrations/earning-types-get-all` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| company_id | string | yes | The UUID of the company |
| X-Gusto-API-Version | string | no | Determines the date-based API version associated with your API call. If none is provided, your application's [minimum API… |

### Create a custom earning type
`POST https://apizie.tech/v1/finance:gusto-app-integrations/earning-types-create-custom-earning-type` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| company_id | string | yes | The UUID of the company |
| X-Gusto-API-Version | string | no | Determines the date-based API version associated with your API call. If none is provided, your application's [minimum API… |
| body | object | no | JSON request body |

### Update an earning type
`POST https://apizie.tech/v1/finance:gusto-app-integrations/earning-types-update-type-by-id` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| company_id | string | yes | The UUID of the company |
| earning_type_uuid | string | yes | The UUID of the earning type |
| X-Gusto-API-Version | string | no | Determines the date-based API version associated with your API call. If none is provided, your application's [minimum API… |
| body | object | no | JSON request body |

### Deactivate an earning type
`POST https://apizie.tech/v1/finance:gusto-app-integrations/earning-types-deactivate` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| company_id | string | yes | The UUID of the company |
| earning_type_uuid | string | yes | The UUID of the earning type |
| X-Gusto-API-Version | string | no | Determines the date-based API version associated with your API call. If none is provided, your application's [minimum API… |

### Get contractors of a company
`GET https://apizie.tech/v1/finance:gusto-app-integrations/contractors-get-all` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| company_id | string | yes | The UUID of the company |
| page | number | no | The page that is requested. When unspecified, will load all objects unless endpoint forces pagination. |
| per | number | no | Number of objects per page. For majority of endpoints will default to 25 |
| X-Gusto-API-Version | string | no | Determines the date-based API version associated with your API call. If none is provided, your application's [minimum API… |

### Create a contractor
`POST https://apizie.tech/v1/finance:gusto-app-integrations/contractors-create-individual-or-business` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| company_id | string | yes | The UUID of the company |
| X-Gusto-API-Version | string | no | Determines the date-based API version associated with your API call. If none is provided, your application's [minimum API… |
| body | object | no | JSON request body |

### Get a contractor
`GET https://apizie.tech/v1/finance:gusto-app-integrations/contractors-get-details` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| contractor_id | string | yes | The UUID of the contractor |
| X-Gusto-API-Version | string | no | Determines the date-based API version associated with your API call. If none is provided, your application's [minimum API… |

### Update a contractor
`POST https://apizie.tech/v1/finance:gusto-app-integrations/contractors-update-contractor` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| contractor_id | string | yes | The UUID of the contractor |
| X-Gusto-API-Version | string | no | Determines the date-based API version associated with your API call. If none is provided, your application's [minimum API… |
| body | object | no | JSON request body |

### List webhook subscriptions
`GET https://apizie.tech/v1/finance:gusto-app-integrations/webhooks-list-subscriptions` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-Gusto-API-Version | string | no | Determines the date-based API version associated with your API call. If none is provided, your application's [minimum API… |

### Create a webhook subscription
`POST https://apizie.tech/v1/finance:gusto-app-integrations/webhooks-create-subscription` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-Gusto-API-Version | string | no | Determines the date-based API version associated with your API call. If none is provided, your application's [minimum API… |
| body | object | no | JSON request body |

### Get a webhook subscription
`GET https://apizie.tech/v1/finance:gusto-app-integrations/webhooks-get-subscription-by-uuid` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| webhook_subscription_uuid | string | yes | The webhook subscription UUID. |
| X-Gusto-API-Version | string | no | Determines the date-based API version associated with your API call. If none is provided, your application's [minimum API… |

### Update a webhook subscription
`POST https://apizie.tech/v1/finance:gusto-app-integrations/webhooks-update-subscription-by-uuid` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| webhook_subscription_uuid | string | yes | The webhook subscription UUID. |
| X-Gusto-API-Version | string | no | Determines the date-based API version associated with your API call. If none is provided, your application's [minimum API… |
| body | object | no | JSON request body |

### Delete a webhook subscription
`POST https://apizie.tech/v1/finance:gusto-app-integrations/webhooks-delete-subscription-by-uuid` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| webhook_subscription_uuid | string | yes | The webhook subscription UUID. |
| X-Gusto-API-Version | string | no | Determines the date-based API version associated with your API call. If none is provided, your application's [minimum API… |

### Verify the webhook subscription
`POST https://apizie.tech/v1/finance:gusto-app-integrations/webhooks-verify-subscription-token` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| webhook_subscription_uuid | string | yes | The webhook subscription UUID. |
| X-Gusto-API-Version | string | no | Determines the date-based API version associated with your API call. If none is provided, your application's [minimum API… |
| body | object | no | JSON request body |

### Request the webhook subscription verification_token
`GET https://apizie.tech/v1/finance:gusto-app-integrations/webhooks-request-verification-token` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| webhook_subscription_uuid | string | yes | The webhook subscription UUID. |
| X-Gusto-API-Version | string | no | Determines the date-based API version associated with your API call. If none is provided, your application's [minimum API… |

### Get all payrolls for a company
`GET https://apizie.tech/v1/finance:gusto-app-integrations/payrolls-get-all-for-company` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| company_id | string | yes | The UUID of the company |
| processing_statuses | string | no | Whether to include processed and/or unprocessed payrolls in the response, defaults to processed, for multiple attributes comma separate… |
| payroll_types | string | no | Whether to include regular and/or off_cycle payrolls in the response, defaults to regular, for multiple attributes comma separate the… |
| include | string | no | Include the requested attribute in the response. In v2023-04-01 totals are no longer included by default. For multiple attributes comma… |
| start_date | string | no | Return payrolls whose pay period is after the start date |
| end_date | string | no | Return payrolls whose pay period is before the end date |
| X-Gusto-API-Version | string | no | Determines the date-based API version associated with your API call. If none is provided, your application's [minimum API… |

### Get a single payroll
`GET https://apizie.tech/v1/finance:gusto-app-integrations/payrolls-get-single-payroll` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| company_id | string | yes | The UUID of the company |
| payroll_id | string | yes | The UUID of the payroll |
| include | string | no | Include the requested attribute in the response, for multiple attributes comma separate the values, i.e.… |
| X-Gusto-API-Version | string | no | Determines the date-based API version associated with your API call. If none is provided, your application's [minimum API… |

### Update a payroll by ID
`POST https://apizie.tech/v1/finance:gusto-app-integrations/payrolls-update-by-id` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| company_id | string | yes | The UUID of the company |
| payroll_id | string | yes | The UUID of the payroll |
| X-Gusto-API-Version | string | no | Determines the date-based API version associated with your API call. If none is provided, your application's [minimum API… |
| body | object | no | JSON request body |

### Prepare a payroll for update
`POST https://apizie.tech/v1/finance:gusto-app-integrations/payrolls-prepare-for-update` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| company_id | string | yes | The UUID of the company |
| payroll_id | string | yes | The UUID of the payroll |
| X-Gusto-API-Version | string | no | Determines the date-based API version associated with your API call. If none is provided, your application's [minimum API… |

### Calculate accruing time off hours
`POST https://apizie.tech/v1/finance:gusto-app-integrations/time-off-policies-calculate-accruing-time-off-hours` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| payroll_id | string | yes | The UUID of the payroll |
| employee_id | string | yes | The UUID of the employee |
| X-Gusto-API-Version | string | no | Determines the date-based API version associated with your API call. If none is provided, your application's [minimum API… |
| body | object | no | JSON request body |

### Get contractor payments for a company
`GET https://apizie.tech/v1/finance:gusto-app-integrations/contractor-payments-list-for-company` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| company_id | string | yes | The UUID of the company |
| start_date | string | yes | The time period for which to retrieve contractor payments |
| end_date | string | yes | The time period for which to retrieve contractor payments |
| contractor_uuid | string | no | The UUID of the contractor. When specified, will load all payments for that contractor. |
| group_by_date | boolean | no | Display contractor payments results group by check date if set to true. |
| page | number | no | The page that is requested. When unspecified, will load all objects unless endpoint forces pagination. |
| per | number | no | Number of objects per page. For majority of endpoints will default to 25 |
| X-Gusto-API-Version | string | no | Determines the date-based API version associated with your API call. If none is provided, your application's [minimum API… |

### Get a single contractor payment
`GET https://apizie.tech/v1/finance:gusto-app-integrations/contractor-payments-get-single` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| company_id | string | yes | The UUID of the company |
| contractor_payment_id | string | yes | The UUID of the contractor payment |
| X-Gusto-API-Version | string | no | Determines the date-based API version associated with your API call. If none is provided, your application's [minimum API… |

### Get benefits for a company
`GET https://apizie.tech/v1/finance:gusto-app-integrations/company-benefits-get-by-company-id` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| company_id | string | yes | The UUID of the company |
| enrollment_count | boolean | no | Whether to return employee enrollment count |
| X-Gusto-API-Version | string | no | Determines the date-based API version associated with your API call. If none is provided, your application's [minimum API… |

### Create a company benefit
`POST https://apizie.tech/v1/finance:gusto-app-integrations/company-benefits-create-company-benefit` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| company_id | string | yes | The UUID of the company |
| X-Gusto-API-Version | string | no | Determines the date-based API version associated with your API call. If none is provided, your application's [minimum API… |
| body | object | no | JSON request body |

### Get a company benefit
`GET https://apizie.tech/v1/finance:gusto-app-integrations/company-benefits-get-by-id` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| company_benefit_id | string | yes | The UUID of the company benefit |
| with_employee_benefits | boolean | no | Whether to return employee benefits associated with the benefit |
| X-Gusto-API-Version | string | no | Determines the date-based API version associated with your API call. If none is provided, your application's [minimum API… |

### Update a company benefit
`POST https://apizie.tech/v1/finance:gusto-app-integrations/company-benefits-update-benefit` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| company_benefit_id | string | yes | The UUID of the company benefit |
| X-Gusto-API-Version | string | no | Determines the date-based API version associated with your API call. If none is provided, your application's [minimum API… |
| body | object | no | JSON request body |

### Delete a company benefit
`POST https://apizie.tech/v1/finance:gusto-app-integrations/company-benefits-remove-benefit` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| company_benefit_id | string | yes | The UUID of the company benefit |
| X-Gusto-API-Version | string | no | Determines the date-based API version associated with your API call. If none is provided, your application's [minimum API… |

### Get all benefits supported by Gusto
`GET https://apizie.tech/v1/finance:gusto-app-integrations/company-benefits-get-all-supported-benefits` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-Gusto-API-Version | string | no | Determines the date-based API version associated with your API call. If none is provided, your application's [minimum API… |

### Get a supported benefit by ID
`GET https://apizie.tech/v1/finance:gusto-app-integrations/company-benefits-get-supported-benefit-by-id` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| benefit_id | string | yes | The benefit type in Gusto. |
| X-Gusto-API-Version | string | no | Determines the date-based API version associated with your API call. If none is provided, your application's [minimum API… |

### Get company benefit summary by company benefit id.
`GET https://apizie.tech/v1/finance:gusto-app-integrations/company-benefits-get-summary-by-id` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| company_benefit_id | string | yes | The UUID of the company benefit |
| start_date | string | no | The start date for which to retrieve company benefit summary |
| end_date | string | no | The end date for which to retrieve company benefit summary |
| detailed | boolean | no | Display employee payroll item summary |
| X-Gusto-API-Version | string | no | Determines the date-based API version associated with your API call. If none is provided, your application's [minimum API… |

### Get benefit fields requirements by ID
`GET https://apizie.tech/v1/finance:gusto-app-integrations/company-benefits-get-fields-requirements-by-id` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| benefit_id | string | yes | The benefit type in Gusto. |
| X-Gusto-API-Version | string | no | Determines the date-based API version associated with your API call. If none is provided, your application's [minimum API… |

### Get all benefits for an employee
`GET https://apizie.tech/v1/finance:gusto-app-integrations/employee-benefits-get-all-for-employee` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| employee_id | string | yes | The UUID of the employee |
| page | number | no | The page that is requested. When unspecified, will load all objects unless endpoint forces pagination. |
| per | number | no | Number of objects per page. For majority of endpoints will default to 25 |
| X-Gusto-API-Version | string | no | Determines the date-based API version associated with your API call. If none is provided, your application's [minimum API… |

### Create an employee benefit
`POST https://apizie.tech/v1/finance:gusto-app-integrations/employee-benefits-create-benefit` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| employee_id | string | yes | The UUID of the employee |
| X-Gusto-API-Version | string | no | Determines the date-based API version associated with your API call. If none is provided, your application's [minimum API… |
| body | object | no | JSON request body |

### Get an employee benefit
`GET https://apizie.tech/v1/finance:gusto-app-integrations/employee-benefits-get-by-id` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| employee_benefit_id | string | yes | The UUID of the employee benefit. |
| X-Gusto-API-Version | string | no | Determines the date-based API version associated with your API call. If none is provided, your application's [minimum API… |

### Update an employee benefit
`POST https://apizie.tech/v1/finance:gusto-app-integrations/employee-benefits-update-benefit` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| employee_benefit_id | string | yes | The UUID of the employee benefit. |
| X-Gusto-API-Version | string | no | Determines the date-based API version associated with your API call. If none is provided, your application's [minimum API… |
| body | object | no | JSON request body |

### Delete an employee benefit
`POST https://apizie.tech/v1/finance:gusto-app-integrations/employee-benefits-remove-benefit` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| employee_benefit_id | string | yes | The UUID of the employee benefit. |
| X-Gusto-API-Version | string | no | Determines the date-based API version associated with your API call. If none is provided, your application's [minimum API… |

### Create year-to-date benefit amounts from a different company
`POST https://apizie.tech/v1/finance:gusto-app-integrations/employee-benefits-create-ytd-benefit-amounts-from-different` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| employee_id | string | yes | The UUID of the employee |
| X-Gusto-API-Version | string | no | Determines the date-based API version associated with your API call. If none is provided, your application's [minimum API… |
| body | object | no | JSON request body |

### Get garnishments for an employee
`GET https://apizie.tech/v1/finance:gusto-app-integrations/garnishments-get-employee-garnishments` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| employee_id | string | yes | The UUID of the employee |
| page | number | no | The page that is requested. When unspecified, will load all objects unless endpoint forces pagination. |
| per | number | no | Number of objects per page. For majority of endpoints will default to 25 |
| X-Gusto-API-Version | string | no | Determines the date-based API version associated with your API call. If none is provided, your application's [minimum API… |

### Create a garnishment
`POST https://apizie.tech/v1/finance:gusto-app-integrations/garnishments-create-garnishment` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| employee_id | string | yes | The UUID of the employee |
| X-Gusto-API-Version | string | no | Determines the date-based API version associated with your API call. If none is provided, your application's [minimum API… |
| body | object | no | JSON request body |

### Get a garnishment
`GET https://apizie.tech/v1/finance:gusto-app-integrations/garnishments-get` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| garnishment_id | string | yes | The UUID of the garnishment |
| X-Gusto-API-Version | string | no | Determines the date-based API version associated with your API call. If none is provided, your application's [minimum API… |

### Update a garnishment
`POST https://apizie.tech/v1/finance:gusto-app-integrations/garnishments-update` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| garnishment_id | string | yes | The UUID of the garnishment |
| X-Gusto-API-Version | string | no | Determines the date-based API version associated with your API call. If none is provided, your application's [minimum API… |
| body | object | no | JSON request body |

### Get all events
`GET https://apizie.tech/v1/finance:gusto-app-integrations/events-get-all` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| starting_after_uuid | string | no | A cursor for pagination. Returns all events occuring after the specified UUID (exclusive) |
| resource_uuid | string | no | The UUID of the company. If not specified, will return all events for all companies. |
| limit | string | no | Limits the number of objects returned in a single response, between 1 and 100. The default is 25 |
| event_type | string | no | A string containing the exact event name (e.g. `employee.created`), or use a wildcard match to filter for a group of events (e.g.… |
| X-Gusto-API-Version | string | no | Determines the date-based API version associated with your API call. If none is provided, your application's [minimum API… |

## Example
```
curl "https://apizie.tech/v1/finance:gusto-app-integrations/introspection-access-token-info" \
  -H "x-api-key: $APIZIE_KEY" \
  -H "x-upstream-key: $PROVIDER_KEY"
```

## FAQ

### How do I call the Gusto API API?
Create a free Apizie key, then send GET https://apizie.tech/v1/finance:gusto-app-integrations/introspection-access-token-info with the header x-api-key. Every endpoint returns { project, data, timestamp }.

### Is the Gusto API API free on Apizie?
Yes. The Free plan includes 1,000 requests a month at 100 requests a minute, no credit card. Gusto API itself also needs your own key from api.gusto.com.

### Can AI agents use the Gusto API API?
Yes. Add the Apizie MCP server (https://apizie.tech/mcp) to Claude, ChatGPT, Cursor or VS Code, then ask in plain language. The agent calls run_scraper with project key finance:gusto-app-integrations.

### What is the status of the Gusto API API?
Needs your own provider key (bring your own key)