Lodol Docs

Gusto

API actions for the Gusto integration.

Gusto

Manage payroll and HR data from your Gusto account via OAuth.


Get current company

Retrieve the company associated with the current Gusto access token.

Response

{
  "company": {
    "id": "7757616923531095",
    "name": "Acme Corp",
    "trade_name": "Acme"
  }
}

Get employee

Retrieve details for a specific employee by ID.

Parameters

ParameterTypeRequiredDescription
employee_idstringYesThe ID of the employee to retrieve

Response

{
  "employee": {
    "department": "Engineering",
    "email": "jane.doe@example.com",
    "first_name": "Jane",
    "id": "7757869450227066",
    "last_name": "Doe"
  }
}

List company employees

Retrieve all employees for a specific company.

Parameters

ParameterTypeRequiredDescription
company_idstringYesThe ID of the company to list employees for
statusstringNoFilter employees by status (e.g., active, terminated)

Response

{
  "employees": [
    {
      "email": "jane.doe@example.com",
      "first_name": "Jane",
      "id": "7757869450227066",
      "last_name": "Doe"
    }
  ]
}

List payrolls

Retrieve payrolls for a specific company.

Parameters

ParameterTypeRequiredDescription
company_idstringYesThe ID of the company to list payrolls for
pagenumberNoPage number for pagination

Response

{
  "payrolls": [
    {
      "check_date": "2024-01-20",
      "id": "7757869450227099",
      "pay_period_end_date": "2024-01-15",
      "pay_period_start_date": "2024-01-01"
    }
  ]
}

On this page