Gusto

Manage payroll, employees, and benefits via the Gusto API.

Detail	Value
Category	HR
Base URL	https://api.gusto.com/v1
Authentication	OAuth2
Endpoints	5
Connector key	gusto

Using Gusto in a workflow

1. Go to Connections and click New Connection.
2. Pick Gusto from the marketplace.
3. Enter your credentials (see Authentication above for what's expected).
4. In a workflow, drop an API Call node and select this connection.
5. Pick the operation you need from the Operation dropdown. The full list is below.

Available endpoints

Endpoint	Summary
GET /companies/{companyId}/employees	List employees
POST /companies/{companyId}/employees	Create an employee
GET /companies/{companyId}/payrolls	List payrolls
GET /companies/{companyId}	Get company details
GET /companies/{companyId}/benefits	List company benefits

Each endpoint is documented in full below. Use the outline on the right to jump to one.

GET /companies/{companyId}/employees

List employees

Detail	Value
Operation ID	hr.listEmployees
Method	GET
Path	/companies/{companyId}/employees

Parameters

Name	Location	Type	Required
companyId	path	string	Yes

Using this endpoint in a workflow

1. Add an API Call node to your workflow.
2. Pick your Gusto connection from the Connection dropdown.
3. In the Operation dropdown, select hr.listEmployees.
4. Fill in the parameter fields that appear. Use {{...}} to reference upstream values.

Required fields are marked: fill them or the call will fail at runtime.

What it returns

The API Call node writes the response to the workflow context:

{
  status: 200,
  success: true,
  data: { ...response body from the API... },
  latencyMs: 142
}

Reference response fields downstream as {{nodeId.data.path}}. The exact response shape is documented on the upstream Gusto API reference.

POST /companies/{companyId}/employees

Create an employee

Detail	Value
Operation ID	hr.createEmployee
Method	POST
Path	/companies/{companyId}/employees

Parameters

Name	Location	Type	Required
companyId	path	string	Yes

Using this endpoint in a workflow

1. Add an API Call node to your workflow.
2. Pick your Gusto connection from the Connection dropdown.
3. In the Operation dropdown, select hr.createEmployee.
4. Fill in the parameter fields that appear. Use {{...}} to reference upstream values.

Required fields are marked: fill them or the call will fail at runtime.

What it returns

The API Call node writes the response to the workflow context:

{
  status: 200,
  success: true,
  data: { ...response body from the API... },
  latencyMs: 142
}

Reference response fields downstream as {{nodeId.data.path}}. The exact response shape is documented on the upstream Gusto API reference.

GET /companies/{companyId}/payrolls

List payrolls

Detail	Value
Operation ID	hr.listPayrolls
Method	GET
Path	/companies/{companyId}/payrolls

Parameters

Name	Location	Type	Required
companyId	path	string	Yes

Using this endpoint in a workflow

1. Add an API Call node to your workflow.
2. Pick your Gusto connection from the Connection dropdown.
3. In the Operation dropdown, select hr.listPayrolls.
4. Fill in the parameter fields that appear. Use {{...}} to reference upstream values.

Required fields are marked: fill them or the call will fail at runtime.

What it returns

The API Call node writes the response to the workflow context:

{
  status: 200,
  success: true,
  data: { ...response body from the API... },
  latencyMs: 142
}

Reference response fields downstream as {{nodeId.data.path}}. The exact response shape is documented on the upstream Gusto API reference.

GET /companies/{companyId}

Get company details

Detail	Value
Operation ID	hr.getCompany
Method	GET
Path	/companies/{companyId}

Parameters

Name	Location	Type	Required
companyId	path	string	Yes

Using this endpoint in a workflow

1. Add an API Call node to your workflow.
2. Pick your Gusto connection from the Connection dropdown.
3. In the Operation dropdown, select hr.getCompany.
4. Fill in the parameter fields that appear. Use {{...}} to reference upstream values.

Required fields are marked: fill them or the call will fail at runtime.

What it returns

The API Call node writes the response to the workflow context:

{
  status: 200,
  success: true,
  data: { ...response body from the API... },
  latencyMs: 142
}

Reference response fields downstream as {{nodeId.data.path}}. The exact response shape is documented on the upstream Gusto API reference.

GET /companies/{companyId}/benefits

List company benefits

Detail	Value
Operation ID	hr.listBenefits
Method	GET
Path	/companies/{companyId}/benefits

Parameters

Name	Location	Type	Required
companyId	path	string	Yes

Using this endpoint in a workflow

1. Add an API Call node to your workflow.
2. Pick your Gusto connection from the Connection dropdown.
3. In the Operation dropdown, select hr.listBenefits.
4. Fill in the parameter fields that appear. Use {{...}} to reference upstream values.

Required fields are marked: fill them or the call will fail at runtime.

What it returns

The API Call node writes the response to the workflow context:

{
  status: 200,
  success: true,
  data: { ...response body from the API... },
  latencyMs: 142
}

Reference response fields downstream as {{nodeId.data.path}}. The exact response shape is documented on the upstream Gusto API reference.