Skip to main content

Gusto Component

Manage payroll, benefits, and human resource within Gusto

Component key: gusto · Changelog ↓

Description​

Gusto is a company that provides a cloud-based payroll, benefits, and human resource management software for businesses based in the United States.

Connections​

OAuth 2.0​

key: gustoOauth

To create an OAuth 2.0 app in Gusto, sign up for a Gusto developer account at https://dev.gusto.com/ and create a new Gusto application. Take note of your applications's Client ID and Secret and enter those values when you add a Gusto connection to your integration. Under Redirect URI, add the callback URL, https://oauth2.prismatic.io/callback.

InputNotesExample
Authorize URL

The OAuth 2.0 Authorization URL for Gusto

https://api.gusto.com/oauth/authorize
Client ID

Client Identifier of your app for the API

Client ID
Client Secret

Client Secret of your app for the API

Client Secret
Scopes

Scopes are not used for Gusto

Token URL

The OAuth 2.0 Token URL for Gusto

https://api.gusto.com/oauth/token

Triggers​

Webhook​

Receive and validate webhook requests from Gusto for webhooks you configure. | key: gustoWebhookTrigger

InputNotesExample
Connection

A Gusto webhook subscription can be configured to send event notifications to a flow's webhook URL when resources change in a Gusto account (an "Employee" is created, a "Payroll" is paid, etc.).

How It Works​

When a webhook subscription is first created, Gusto sends a verification request containing a verification_token to the webhook endpoint. This request is routed to the URL Validation branch beneath the trigger. The trigger automatically handles the verification by calling the Gusto API to confirm the token, then responds with the token in the response body.

All subsequent webhook event notifications are routed to the Notification branch.

Configuration​

The trigger requires an OAuth 2.0 connection to authenticate with the Gusto API for webhook verification.

To set up a webhook subscription:

  1. Deploy the instance so the flow's webhook URL is available.
  2. Use the Create Webhook Subscription action (or the Gusto API directly) to create a subscription, providing the flow's webhook URL and the desired subscription types.
  3. Gusto sends a verification request to the webhook URL, which the trigger handles automatically.
  4. Once verified, the subscription becomes active and event notifications begin flowing to the Notification branch.

Event Types​

Available Subscription Types and Events (21 categories)
Subscription TypeEvents
BankAccountcreated, updated, deleted
Companyprovisioned, deprovisioned, partner_authorized, migrated, updated, onboarded, approved, needs_approval, marked_as_high_risk_business, marked_as_marijuana_business, suspended, unsuspended, payroll_transfer_completed
CompanyBenefitcreated, updated, deleted
Contractorcreated, updated, onboarded, deactivated, reactivated, deleted
ContractorPaymentcreated, cancelled
ContractorPaymentGroupcreated, cancelled
Documentcreated, updated, signed
Employeecreated, updated, onboarded, marked_for_self_onboarding, terminated, rehired, deleted, invited_to_partner_portal
EmployeeBenefitcreated, updated, deleted
EmployeeJobCompensationcreated, updated, deleted
ExternalPayrollcreated, updated, deleted
FastAchConfigactivated, deactivated
Formcreated, updated, signed
GeneratedDocumentgenerated, failed
HomeAddresscreated, updated, deleted
Locationcreated, updated
Notificationscreated, resolved
Payrollcreated, updated, calculated, submitted, processed, paid, reversed, partially_reversed, cancelled, processing_failed
PaySchedulecreated, updated
Signatorycreated, updated, deleted, marked_for_invite
WorkAddresscreated, updated, deleted

Refer to the Gusto Webhook Events documentation for the complete and up-to-date list of event types.

Returned Data​

Example Payload
{
  "uuid": "evt_abc123-def456",
  "event_type": "payroll.paid",
  "resource_type": "Company",
  "entity_type": "Payroll",
  "entity_uuid": "pay_xyz789",
  "timestamp": 1705312200,
  "partner_uuid": "partner_abc123",
  "company_uuid": "company_def456"
}

Notes​

  • A single API request may generate multiple webhook events.
  • Gusto retries delivery up to 16 times over 3 days if the endpoint does not return a 2xx response within 10 seconds.
  • Gusto computes an HMAC-SHA256 signature of the event payload using the verification_token as the secret. The signature is sent in the X-Gusto-Signature header and can be used to validate that events originate from Gusto.

Data Sources​

Select Company​

A picklist of companies in your Gusto account. | key: selectCompany | type: picklist

InputNotesExample
Connection

{
  "result": [
    {
      "label": "Acme Corporation",
      "key": "c44d66dc-c41b-4a60-9e25-5e93ff8583f2"
    }
  ]
}

Select Employee​

A picklist of employees for the selected company. | key: selectEmployee | type: picklist

InputNotesExample
Company ID

A UUID representing a company.

00000000-0000-0000-0000-000000000000
Connection

{
  "result": [
    {
      "label": "Nicole Boehm",
      "key": "9779767c-6044-48e0-bf68-aeb370b9a2e7"
    }
  ]
}

Select Pay Schedule​

A picklist of pay schedules for the selected company. | key: selectPaySchedule | type: picklist

InputNotesExample
Company ID

A UUID representing a company.

00000000-0000-0000-0000-000000000000
Connection

{
  "result": [
    {
      "label": "Engineering (Twice per month)",
      "key": "2097fe08-407a-46d7-b35c-a32402a2355e"
    }
  ]
}

Actions​

Create Employee​

Create an employee of a company | key: createEmployee

InputNotesExample
Company ID

A UUID representing a company.

00000000-0000-0000-0000-000000000000
Connection
Date of Birth

The employee's date of birth.

1990-12-30
Email Address

The employee's personal email address.

john.doe@example.com
First Name

The employee's first name.

Last Name

The employee's last name.

Middle Initial

The employee's middle initial.

Social Security Number

The employee's social security number.

123-45-6789

{
  "data": {
    "data": {
      "uuid": "9779767c-6044-48e0-bf68-aeb370b9a2e7",
      "first_name": "Nicole",
      "middle_initial": "M",
      "last_name": "Boehm",
      "email": "kory7757869450111548@barton-hermiston.io",
      "company_uuid": "c44d66dc-c41b-4a60-9e25-5e93ff8583f2",
      "manager_uuid": "5e53e257-c8d6-45aa-aa8a-ec99283a3acd",
      "version": "414dedaca594b77135e0b8d2f398516d",
      "department": "Stage Hand",
      "department_uuid": "1802465d-4f68-4865-920c-1307ab095f12",
      "terminated": false,
      "two_percent_shareholder": false,
      "onboarded": true,
      "jobs": [
        {
          "uuid": "5d5e3ce5-ea8f-4885-90e5-7ebaed03f7c5",
          "version": "91179081a7309c9fbd31bb3cf7b9893e",
          "employee_uuid": "a987bce1-6d06-43f8-9978-9db886f479fb",
          "current_compensation_uuid": "798a962f-0fcf-491e-9b71-cfa6a1db114f",
          "payment_unit": "Hour",
          "primary": true,
          "title": "Client Support Manager",
          "compensations": [
            {
              "uuid": "94f17a77-cfe5-436a-af94-422bbf8248ff",
              "version": "233f0096a8015e62d9795fadf1fd300d",
              "payment_unit": "Hour",
              "flsa_status": "Nonexempt",
              "job_uuid": "64711ac0-83ff-4aaf-bec1-db72f5a44e56",
              "effective_date": "2021-01-20",
              "rate": "22.00",
              "adjust_for_minimum_wage": false,
              "minimum_wages": []
            }
          ],
          "rate": "22.00",
          "hire_date": "2020-01-20",
          "location": {
            "uuid": "a82843df-3e90-4f4c-93bc-808122f88a46",
            "street_1": "412 Kiera Stravenue",
            "street_2": "Suite 391",
            "city": "San Francisco",
            "state": "CA",
            "zip": "94107",
            "country": "USA",
            "inactive": false
          }
        }
      ],
      "eligible_paid_time_off": [
        {
          "name": "Sick Hours",
          "accrual_unit": "Hour",
          "accrual_rate": "208.0",
          "accrual_method": "per_hour_worked",
          "accrual_period": "Year",
          "accrual_balance": "71.0",
          "maximum_accrual_balance": "240.0",
          "paid_at_termination": false
        },
        {
          "name": "Vacation Hours",
          "accrual_unit": "Hour",
          "accrual_rate": "208.0",
          "accrual_period": "Year",
          "accrual_balance": "34.0",
          "maximum_accrual_balance": "240.0",
          "paid_at_termination": true
        }
      ],
      "terminations": [],
      "home_address": {
        "version": "7776defce07496b82f3f1ed469e48ae5",
        "employee_uuid": "628d203c-357b-4dd4-9ea1-8468b15dd58b",
        "street_1": "3772 Reynolds Centers",
        "street_2": "Suite 461",
        "city": "San Francisco",
        "state": "CA",
        "zip": "94107",
        "country": "USA",
        "active": true
      },
      "garnishments": [],
      "date_of_birth": "1996-05-08",
      "has_ssn": true,
      "ssn": "",
      "phone": "1234567890",
      "preferred_first_name": "Vanessa",
      "work_email": "vanessa.boehm@example.com"
    },
    "headers": {}
  }
}

Create Webhook Subscription​

Creates a Webhook Subscription to receive notifications when entities change for Gusto. | key: createWebhookSubscription

InputNotesExample
Connection
Subscription Types

Types of notifications to receive when entities change. Enter as comma-separated values.

type1,type2
Webhook URL

The URL for the webhook subscription.

https://example.com/webhooks

{
  "data": {
    "data": {
      "uuid": "a3d8e410-7b6c-4f2a-9c4e-1d8f5b3a7e90",
      "url": "https://example.com/webhooks/gusto",
      "status": "verified",
      "subscription_types": [
        "Employee",
        "Company"
      ]
    },
    "headers": {}
  }
}

Delete Webhook Subscription​

Deletes the Webhook Subscription associated with the provided UUID for Gusto. | key: deleteWebhookSubscription

InputNotesExample
Connection
Webhook Subscription UUID

The webhook subscription UUID.

00000000-0000-0000-0000-000000000000

{
  "data": {
    "message": "The resource was deleted successfully."
  }
}

Find Employee by Email​

Get an employee by personal email address. | key: findEmployeeByEmail

InputNotesExample
Company ID

A UUID representing a company.

00000000-0000-0000-0000-000000000000
Connection
Email Address

The employee's personal email address.

john.doe@example.com

{
  "data": {
    "data": {
      "uuid": "9779767c-6044-48e0-bf68-aeb370b9a2e7",
      "first_name": "Nicole",
      "middle_initial": "M",
      "last_name": "Boehm",
      "email": "kory7757869450111548@barton-hermiston.io",
      "company_uuid": "c44d66dc-c41b-4a60-9e25-5e93ff8583f2",
      "manager_uuid": "5e53e257-c8d6-45aa-aa8a-ec99283a3acd",
      "version": "414dedaca594b77135e0b8d2f398516d",
      "department": "Stage Hand",
      "department_uuid": "1802465d-4f68-4865-920c-1307ab095f12",
      "terminated": false,
      "two_percent_shareholder": false,
      "onboarded": true,
      "jobs": [
        {
          "uuid": "5d5e3ce5-ea8f-4885-90e5-7ebaed03f7c5",
          "version": "91179081a7309c9fbd31bb3cf7b9893e",
          "employee_uuid": "a987bce1-6d06-43f8-9978-9db886f479fb",
          "current_compensation_uuid": "798a962f-0fcf-491e-9b71-cfa6a1db114f",
          "payment_unit": "Hour",
          "primary": true,
          "title": "Client Support Manager",
          "compensations": [
            {
              "uuid": "94f17a77-cfe5-436a-af94-422bbf8248ff",
              "version": "233f0096a8015e62d9795fadf1fd300d",
              "payment_unit": "Hour",
              "flsa_status": "Nonexempt",
              "job_uuid": "64711ac0-83ff-4aaf-bec1-db72f5a44e56",
              "effective_date": "2021-01-20",
              "rate": "22.00",
              "adjust_for_minimum_wage": false,
              "minimum_wages": []
            }
          ],
          "rate": "22.00",
          "hire_date": "2020-01-20",
          "location": {
            "uuid": "a82843df-3e90-4f4c-93bc-808122f88a46",
            "street_1": "412 Kiera Stravenue",
            "street_2": "Suite 391",
            "city": "San Francisco",
            "state": "CA",
            "zip": "94107",
            "country": "USA",
            "inactive": false
          }
        }
      ],
      "eligible_paid_time_off": [
        {
          "name": "Sick Hours",
          "accrual_unit": "Hour",
          "accrual_rate": "208.0",
          "accrual_method": "per_hour_worked",
          "accrual_period": "Year",
          "accrual_balance": "71.0",
          "maximum_accrual_balance": "240.0",
          "paid_at_termination": false
        },
        {
          "name": "Vacation Hours",
          "accrual_unit": "Hour",
          "accrual_rate": "208.0",
          "accrual_period": "Year",
          "accrual_balance": "34.0",
          "maximum_accrual_balance": "240.0",
          "paid_at_termination": true
        }
      ],
      "terminations": [],
      "home_address": {
        "version": "7776defce07496b82f3f1ed469e48ae5",
        "employee_uuid": "628d203c-357b-4dd4-9ea1-8468b15dd58b",
        "street_1": "3772 Reynolds Centers",
        "street_2": "Suite 461",
        "city": "San Francisco",
        "state": "CA",
        "zip": "94107",
        "country": "USA",
        "active": true
      },
      "garnishments": [],
      "date_of_birth": "1996-05-08",
      "has_ssn": true,
      "ssn": "",
      "phone": "1234567890",
      "preferred_first_name": "Vanessa",
      "work_email": "vanessa.boehm@example.com"
    },
    "headers": {}
  }
}

Get Company by ID​

Get company metadata by ID | key: getCompany

InputNotesExample
Company ID

A UUID representing a company.

00000000-0000-0000-0000-000000000000
Connection

{
  "data": {
    "data": {
      "ein": "00-0000001",
      "entity_type": "C-Corporation",
      "tier": "core",
      "is_suspended": false,
      "company_status": "Approved",
      "uuid": "c7a07c73-a703-4462-9343-1b181182b6e0",
      "name": "Shoppe Studios LLC",
      "trade_name": "Record Shoppe",
      "is_partner_managed": false,
      "locations": [
        {
          "street_1": "412 Kiera Stravenue",
          "street_2": "Suite 391",
          "city": "San Francisco",
          "state": "CA",
          "zip": "94107",
          "country": "USA",
          "active": true
        },
        {
          "street_1": "644 Fay Vista",
          "street_2": "Suite 842",
          "city": "Richmond",
          "state": "VA",
          "zip": "23218",
          "country": "USA",
          "active": true
        }
      ],
      "compensations": {
        "hourly": [
          {
            "name": "Overtime",
            "multiple": 1.5
          },
          {
            "name": "Double overtime",
            "multiple": 2
          },
          {
            "name": "Regular",
            "multiple": 1
          },
          {
            "name": "Outstanding vacation",
            "multiple": 1
          },
          {
            "name": "Holiday",
            "multiple": 1
          },
          {
            "name": "Emergency sick - self care",
            "multiple": 1
          },
          {
            "name": "Emergency sick - caring for others",
            "multiple": 1
          },
          {
            "name": "FMLA Public Health Emergency Leave",
            "multiple": 1
          },
          {
            "name": "Regular Hours",
            "multiple": 1
          }
        ],
        "fixed": [
          {
            "name": "Bonus"
          },
          {
            "name": "Commission"
          },
          {
            "name": "Paycheck Tips"
          },
          {
            "name": "Cash Tips"
          },
          {
            "name": "Correction Payment"
          },
          {
            "name": "Severance"
          },
          {
            "name": "Minimum Wage Adjustment"
          },
          {
            "name": "Reimbursement"
          }
        ],
        "paid_time_off": [
          {
            "name": "Vacation Hours"
          },
          {
            "name": "Sick Hours"
          },
          {
            "name": "Holiday Hours"
          }
        ]
      },
      "primary_signatory": {
        "first_name": "Alda",
        "middle_initial": "",
        "last_name": "Carter",
        "phone": "1-565-710-7558",
        "email": "louie.hessel7757869450111547@zemlak.biz",
        "home_address": {
          "street_1": "524 Roob Divide",
          "street_2": "Suite 565",
          "city": "San Francisco",
          "state": "CA",
          "zip": "94107",
          "country": "USA"
        }
      },
      "primary_payroll_admin": {
        "first_name": "Ian",
        "last_name": "Labadie",
        "phone": "1-565-710-7559",
        "email": "louie.hessel7757869450111547@zemlak.biz"
      }
    },
    "headers": {}
  }
}

Get Employee​

Get an employee by ID | key: getEmployee

InputNotesExample
Connection
Employee ID

A UUID representing a employee.

00000000-0000-0000-0000-000000000000

{
  "data": {
    "data": {
      "uuid": "9779767c-6044-48e0-bf68-aeb370b9a2e7",
      "first_name": "Nicole",
      "middle_initial": "M",
      "last_name": "Boehm",
      "email": "kory7757869450111548@barton-hermiston.io",
      "company_uuid": "c44d66dc-c41b-4a60-9e25-5e93ff8583f2",
      "manager_uuid": "5e53e257-c8d6-45aa-aa8a-ec99283a3acd",
      "version": "414dedaca594b77135e0b8d2f398516d",
      "department": "Stage Hand",
      "department_uuid": "1802465d-4f68-4865-920c-1307ab095f12",
      "terminated": false,
      "two_percent_shareholder": false,
      "onboarded": true,
      "jobs": [
        {
          "uuid": "5d5e3ce5-ea8f-4885-90e5-7ebaed03f7c5",
          "version": "91179081a7309c9fbd31bb3cf7b9893e",
          "employee_uuid": "a987bce1-6d06-43f8-9978-9db886f479fb",
          "current_compensation_uuid": "798a962f-0fcf-491e-9b71-cfa6a1db114f",
          "payment_unit": "Hour",
          "primary": true,
          "title": "Client Support Manager",
          "compensations": [
            {
              "uuid": "94f17a77-cfe5-436a-af94-422bbf8248ff",
              "version": "233f0096a8015e62d9795fadf1fd300d",
              "payment_unit": "Hour",
              "flsa_status": "Nonexempt",
              "job_uuid": "64711ac0-83ff-4aaf-bec1-db72f5a44e56",
              "effective_date": "2021-01-20",
              "rate": "22.00",
              "adjust_for_minimum_wage": false,
              "minimum_wages": []
            }
          ],
          "rate": "22.00",
          "hire_date": "2020-01-20",
          "location": {
            "uuid": "a82843df-3e90-4f4c-93bc-808122f88a46",
            "street_1": "412 Kiera Stravenue",
            "street_2": "Suite 391",
            "city": "San Francisco",
            "state": "CA",
            "zip": "94107",
            "country": "USA",
            "inactive": false
          }
        }
      ],
      "eligible_paid_time_off": [
        {
          "name": "Sick Hours",
          "accrual_unit": "Hour",
          "accrual_rate": "208.0",
          "accrual_method": "per_hour_worked",
          "accrual_period": "Year",
          "accrual_balance": "71.0",
          "maximum_accrual_balance": "240.0",
          "paid_at_termination": false
        },
        {
          "name": "Vacation Hours",
          "accrual_unit": "Hour",
          "accrual_rate": "208.0",
          "accrual_period": "Year",
          "accrual_balance": "34.0",
          "maximum_accrual_balance": "240.0",
          "paid_at_termination": true
        }
      ],
      "terminations": [],
      "home_address": {
        "version": "7776defce07496b82f3f1ed469e48ae5",
        "employee_uuid": "628d203c-357b-4dd4-9ea1-8468b15dd58b",
        "street_1": "3772 Reynolds Centers",
        "street_2": "Suite 461",
        "city": "San Francisco",
        "state": "CA",
        "zip": "94107",
        "country": "USA",
        "active": true
      },
      "garnishments": [],
      "date_of_birth": "1996-05-08",
      "has_ssn": true,
      "ssn": "",
      "phone": "1234567890",
      "preferred_first_name": "Vanessa",
      "work_email": "vanessa.boehm@example.com"
    },
    "headers": {}
  }
}

Get Pay Schedule by ID​

Get a pay schedules for a company by pay schedule ID | key: getPaySchedule

InputNotesExample
Company ID

A UUID representing a company.

00000000-0000-0000-0000-000000000000
Connection
Pay Schedule ID

A UUID representing a pay schedule.

00000000-0000-0000-0000-000000000000

{
  "data": {
    "data": [
      {
        "uuid": "2097fe08-407a-46d7-b35c-a32402a2355e",
        "frequency": "Twice per month",
        "anchor_pay_date": "2020-05-15",
        "anchor_end_of_pay_period": "2020-05-08",
        "day_1": 15,
        "day_2": 31,
        "name": "Engineering",
        "auto_pilot": false
      }
    ],
    "headers": {}
  }
}

Get Webhook Events​

Get webhook events based on the partner application's scopes for Gusto. | key: getWebhookEvents

InputNotesExample
Connection
Event Type

A string containing the exact event name or use a wildcard match to filter for a group of events.

Page

The page that is requested. When unspecified, will load the first page.

Number of Objects per Page

Number of objects per page. When unspecified, will default to 25.

Starting After UUID

Serves as a cursor, returns all events occurring after specified UUID (exclusive).

{
  "data": {
    "data": [
      {
        "uuid": "b7e3c4d1-5a2f-4e8b-9c1d-6f7a8b9c0d1e",
        "event_type": "employee.created",
        "resource_uuid": "9779767c-6044-48e0-bf68-aeb370b9a2e7",
        "resource_type": "Employee",
        "timestamp": 1710504000,
        "entity_uuid": "c7a07c73-a703-4462-9343-1b181182b6e0",
        "partner_uuid": "d4e5f6a7-b8c9-0d1e-2f3a-4b5c6d7e8f9a"
      }
    ],
    "headers": {}
  }
}

Get Webhook Subscription​

Returns the Webhook Subscription associated with the provided UUID for Gusto. | key: getWebhookSubscription

InputNotesExample
Connection
Webhook Subscription UUID

The webhook subscription UUID.

00000000-0000-0000-0000-000000000000

{
  "data": {
    "data": {
      "uuid": "a3d8e410-7b6c-4f2a-9c4e-1d8f5b3a7e90",
      "url": "https://example.com/webhooks/gusto",
      "status": "verified",
      "subscription_types": [
        "Employee",
        "Company"
      ]
    },
    "headers": {}
  }
}

List Companies​

List all companies that the currently authenticated user is a part of | key: listCompanies

InputNotesExample
Connection
Pagination Page

Which page of results to fetch. See Gusto API documentation for more information.

{
  "data": {
    "data": [
      {
        "ein": "00-0000001",
        "entity_type": "C-Corporation",
        "tier": "core",
        "is_suspended": false,
        "company_status": "Approved",
        "uuid": "c7a07c73-a703-4462-9343-1b181182b6e0",
        "name": "Shoppe Studios LLC",
        "trade_name": "Record Shoppe",
        "is_partner_managed": false,
        "locations": [
          {
            "street_1": "412 Kiera Stravenue",
            "street_2": "Suite 391",
            "city": "San Francisco",
            "state": "CA",
            "zip": "94107",
            "country": "USA",
            "active": true
          },
          {
            "street_1": "644 Fay Vista",
            "street_2": "Suite 842",
            "city": "Richmond",
            "state": "VA",
            "zip": "23218",
            "country": "USA",
            "active": true
          }
        ],
        "compensations": {
          "hourly": [
            {
              "name": "Overtime",
              "multiple": 1.5
            },
            {
              "name": "Double overtime",
              "multiple": 2
            },
            {
              "name": "Regular",
              "multiple": 1
            },
            {
              "name": "Outstanding vacation",
              "multiple": 1
            },
            {
              "name": "Holiday",
              "multiple": 1
            },
            {
              "name": "Emergency sick - self care",
              "multiple": 1
            },
            {
              "name": "Emergency sick - caring for others",
              "multiple": 1
            },
            {
              "name": "FMLA Public Health Emergency Leave",
              "multiple": 1
            },
            {
              "name": "Regular Hours",
              "multiple": 1
            }
          ],
          "fixed": [
            {
              "name": "Bonus"
            },
            {
              "name": "Commission"
            },
            {
              "name": "Paycheck Tips"
            },
            {
              "name": "Cash Tips"
            },
            {
              "name": "Correction Payment"
            },
            {
              "name": "Severance"
            },
            {
              "name": "Minimum Wage Adjustment"
            },
            {
              "name": "Reimbursement"
            }
          ],
          "paid_time_off": [
            {
              "name": "Vacation Hours"
            },
            {
              "name": "Sick Hours"
            },
            {
              "name": "Holiday Hours"
            }
          ]
        },
        "primary_signatory": {
          "first_name": "Alda",
          "middle_initial": "",
          "last_name": "Carter",
          "phone": "1-565-710-7558",
          "email": "louie.hessel7757869450111547@zemlak.biz",
          "home_address": {
            "street_1": "524 Roob Divide",
            "street_2": "Suite 565",
            "city": "San Francisco",
            "state": "CA",
            "zip": "94107",
            "country": "USA"
          }
        },
        "primary_payroll_admin": {
          "first_name": "Ian",
          "last_name": "Labadie",
          "phone": "1-565-710-7559",
          "email": "louie.hessel7757869450111547@zemlak.biz"
        }
      }
    ],
    "headers": {}
  }
}

List Company Admins​

List all admin users at a company | key: listCompanyAdmins

InputNotesExample
Company ID

A UUID representing a company.

00000000-0000-0000-0000-000000000000
Connection
Pagination Page

Which page of results to fetch. See Gusto API documentation for more information.

{
  "data": {
    "data": [
      {
        "first_name": "Katherine",
        "last_name": "Johnson",
        "email": "Katherine@acmecorp.com",
        "uuid": "987058cc-23ee-46e9-81ef-5cee086cceca"
      },
      {
        "first_name": "Anita",
        "last_name": "Borg",
        "email": "Anita@acmecorp.com",
        "uuid": "5de11791-98fd-4587-9ed0-d5d804b8e647"
      }
    ],
    "headers": {}
  }
}

List Employees​

List employees of a company | key: listEmployees

InputNotesExample
Company ID

A UUID representing a company.

00000000-0000-0000-0000-000000000000
Connection
Pagination Page

Which page of results to fetch. See Gusto API documentation for more information.

{
  "data": {
    "data": [
      {
        "uuid": "9779767c-6044-48e0-bf68-aeb370b9a2e7",
        "first_name": "Nicole",
        "middle_initial": "M",
        "last_name": "Boehm",
        "email": "kory7757869450111548@barton-hermiston.io",
        "company_uuid": "c44d66dc-c41b-4a60-9e25-5e93ff8583f2",
        "manager_uuid": "5e53e257-c8d6-45aa-aa8a-ec99283a3acd",
        "version": "414dedaca594b77135e0b8d2f398516d",
        "department": "Stage Hand",
        "department_uuid": "1802465d-4f68-4865-920c-1307ab095f12",
        "terminated": false,
        "two_percent_shareholder": false,
        "onboarded": true,
        "jobs": [
          {
            "uuid": "5d5e3ce5-ea8f-4885-90e5-7ebaed03f7c5",
            "version": "91179081a7309c9fbd31bb3cf7b9893e",
            "employee_uuid": "a987bce1-6d06-43f8-9978-9db886f479fb",
            "current_compensation_uuid": "798a962f-0fcf-491e-9b71-cfa6a1db114f",
            "payment_unit": "Hour",
            "primary": true,
            "title": "Client Support Manager",
            "compensations": [
              {
                "uuid": "94f17a77-cfe5-436a-af94-422bbf8248ff",
                "version": "233f0096a8015e62d9795fadf1fd300d",
                "payment_unit": "Hour",
                "flsa_status": "Nonexempt",
                "job_uuid": "64711ac0-83ff-4aaf-bec1-db72f5a44e56",
                "effective_date": "2021-01-20",
                "rate": "22.00",
                "adjust_for_minimum_wage": false,
                "minimum_wages": []
              }
            ],
            "rate": "22.00",
            "hire_date": "2020-01-20",
            "location": {
              "uuid": "a82843df-3e90-4f4c-93bc-808122f88a46",
              "street_1": "412 Kiera Stravenue",
              "street_2": "Suite 391",
              "city": "San Francisco",
              "state": "CA",
              "zip": "94107",
              "country": "USA",
              "inactive": false
            }
          }
        ],
        "eligible_paid_time_off": [
          {
            "name": "Sick Hours",
            "accrual_unit": "Hour",
            "accrual_rate": "208.0",
            "accrual_method": "per_hour_worked",
            "accrual_period": "Year",
            "accrual_balance": "71.0",
            "maximum_accrual_balance": "240.0",
            "paid_at_termination": false
          },
          {
            "name": "Vacation Hours",
            "accrual_unit": "Hour",
            "accrual_rate": "208.0",
            "accrual_period": "Year",
            "accrual_balance": "34.0",
            "maximum_accrual_balance": "240.0",
            "paid_at_termination": true
          }
        ],
        "terminations": [],
        "home_address": {
          "version": "7776defce07496b82f3f1ed469e48ae5",
          "employee_uuid": "628d203c-357b-4dd4-9ea1-8468b15dd58b",
          "street_1": "3772 Reynolds Centers",
          "street_2": "Suite 461",
          "city": "San Francisco",
          "state": "CA",
          "zip": "94107",
          "country": "USA",
          "active": true
        },
        "garnishments": [],
        "date_of_birth": "1996-05-08",
        "has_ssn": true,
        "ssn": "",
        "phone": "1234567890",
        "preferred_first_name": "Vanessa",
        "work_email": "vanessa.boehm@example.com"
      }
    ],
    "headers": {}
  }
}

List Pay Schedules​

List pay schedules for a company | key: listPaySchedules

InputNotesExample
Company ID

A UUID representing a company.

00000000-0000-0000-0000-000000000000
Connection
Pagination Page

Which page of results to fetch. See Gusto API documentation for more information.

{
  "data": {
    "data": [
      {
        "uuid": "2097fe08-407a-46d7-b35c-a32402a2355e",
        "frequency": "Twice per month",
        "anchor_pay_date": "2020-05-15",
        "anchor_end_of_pay_period": "2020-05-08",
        "day_1": 15,
        "day_2": 31,
        "name": "Engineering",
        "auto_pilot": false
      }
    ],
    "headers": {}
  }
}

List Webhook Subscriptions​

Returns all webhook subscriptions associated with the provided Partner API token for Gusto. | key: listWebhookSubscriptions

InputNotesExample
Connection

{
  "data": {
    "data": [
      {
        "uuid": "a3d8e410-7b6c-4f2a-9c4e-1d8f5b3a7e90",
        "url": "https://example.com/webhooks/gusto",
        "status": "verified",
        "subscription_types": [
          "Employee",
          "Company"
        ]
      }
    ],
    "headers": {}
  }
}

Raw Request​

Send raw HTTP request to Gusto | key: rawRequest

InputNotesExample
API Version

The API version to use.

2025-06-15
Connection
Data

The HTTP body payload to send to the URL.

{"exampleKey": "Example Data"}
File Data

File Data to be sent as a multipart form upload.

[{key: "example.txt", value: "My File Contents"}]
File Data File Names

File names to apply to the file data inputs. Keys must match the file data keys above.

Form Data

The Form Data to be sent as a multipart form upload.

[{"key": "Example Key", "value": new Buffer("Hello World")}]
Header

A list of headers to send with the request.

User-Agent: curl/7.64.1
Max Retry Count

The maximum number of retries to attempt. Specify 0 for no retries.

0
Method

The HTTP method to use.

Query Parameter

A list of query parameters to send with the request. This is the portion at the end of the URL similar to ?key1=value1&key2=value2.

Response Type

The type of data you expect in the response. You can request json, text, or binary data.

json
Retry On All Errors

If true, retries on all erroneous responses regardless of type. This is helpful when retrying after HTTP 429 or other 3xx or 4xx errors. Otherwise, only retries on HTTP 5xx and network errors.

false
Retry Delay (ms)

The delay in milliseconds between retries. This is used when 'Use Exponential Backoff' is disabled.

0
Timeout

The maximum time that a client will await a response to its request

2000
URL

Input the path only (/provision), The base URL is already included (https://api.gusto.com/v1). For example, to connect to https://api.gusto.com/v1/provision, only /provision is entered in this field.

/provision
Use Exponential Backoff

Specifies whether to use a pre-defined exponential backoff strategy for retries. When enabled, 'Retry Delay (ms)' is ignored.

false

Terminate Employee​

End an employee's employment | key: terminateEmployee

InputNotesExample
Connection
Employee ID

A UUID representing a employee.

00000000-0000-0000-0000-000000000000
Run Termination Payroll?

Whether to run a termination payroll for the employee.

false
Termination Date

The date the employee was terminated.

2020-12-30

{
  "data": {
    "data": {
      "uuid": "f8a034b0-91e3-4976-b762-3f8a1d47c950",
      "employee_uuid": "9779767c-6044-48e0-bf68-aeb370b9a2e7",
      "active": true,
      "effective_date": "2024-03-15",
      "run_termination_payroll": false
    },
    "headers": {}
  }
}

Update Webhook Subscription​

Updates the Webhook Subscription associated with the provided UUID for Gusto. | key: updateWebhookSubscription

InputNotesExample
Connection
Subscription Types

Types of notifications to receive when entities change. Enter as comma-separated values.

type1,type2
Webhook Subscription UUID

The webhook subscription UUID.

00000000-0000-0000-0000-000000000000

{
  "data": {
    "data": {
      "uuid": "a3d8e410-7b6c-4f2a-9c4e-1d8f5b3a7e90",
      "url": "https://example.com/webhooks/gusto",
      "status": "verified",
      "subscription_types": [
        "Employee",
        "Company"
      ]
    },
    "headers": {}
  }
}

Changelog​

2026-04-13​

  • Updated Example Payloads

2026-04-07​

Added trigger documentation

2026-03-31​

Various modernizations and documentation updates

2026-03-16​

Improved input field documentation with formatted URL links for better readability

2026-02-26​

Added inline data sources for employees and pay schedules to enable dynamic dropdown selection

2025-07-16​

Removed deprecated API token connection in favor of OAuth 2.0

2025-07-14​

Added API version support for compatibility with latest Gusto API