> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kombo.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Insperity HRIS Integration

> Insperity connector for Kombo's HRIS API

<Note>This connector is in open beta. You can freely enable it in your account.</Note>

The Insperity HRIS integration allows you to sync HRIS data between Insperity and your application through Kombo's unified API. The tool slug for this connector is `insperity`.

## Guides and Resources

<CardGroup cols={2}>
  <Card title="Connection Setup Guide" icon="link" href="https://help.kombo.dev/hc/en-us/articles/38957895631377-Insperity-HRIS-How-do-I-link-my-account">
    Step-by-step instructions to connect your Insperity account to Kombo.
  </Card>
</CardGroup>

## Supported Features & Coverage

<Tabs>
  <Tab title="Models">
    <Accordion title="Legal Entities">
      | Field               | Notes |
      | ------------------- | ----- |
      | id                  |       |
      | remote\_id          |       |
      | changed\_at         |       |
      | remote\_deleted\_at |       |
      | name                |       |
      | address             |       |
    </Accordion>

    <Accordion title="Work Locations">
      | Field               | Notes |
      | ------------------- | ----- |
      | id                  |       |
      | remote\_id          |       |
      | changed\_at         |       |
      | remote\_deleted\_at |       |
      | name                |       |
      | address             |       |
    </Accordion>

    <Accordion title="Employees">
      | Field                 | Notes |
      | --------------------- | ----- |
      | id                    |       |
      | remote\_id            |       |
      | changed\_at           |       |
      | remote\_deleted\_at   |       |
      | employee\_number      |       |
      | first\_name           |       |
      | last\_name            |       |
      | display\_full\_name   |       |
      | job\_title            |       |
      | work\_email           |       |
      | personal\_email       |       |
      | mobile\_phone\_number |       |
      | gender                |       |
      | employment\_status    |       |
      | employment\_type      |       |
      | weekly\_hours         |       |
      | work\_location\_id    |       |
      | legal\_entity\_id     |       |
      | manager\_id           |       |
      | home\_address         |       |
      | date\_of\_birth       |       |
      | start\_date           |       |
      | termination\_date     |       |
      | custom\_fields        |       |
      | integration\_fields   |       |
      | remote\_data          |       |
    </Accordion>

    <Accordion title="Absence Types">
      | Field               | Notes |
      | ------------------- | ----- |
      | id                  |       |
      | remote\_id          |       |
      | changed\_at         |       |
      | remote\_deleted\_at |       |
      | name                |       |
      | unit                |       |
      | remote\_data        |       |
    </Accordion>

    <Accordion title="Employments">
      | Field               | Notes |
      | ------------------- | ----- |
      | id                  |       |
      | remote\_id          |       |
      | changed\_at         |       |
      | remote\_deleted\_at |       |
      | employee\_id        |       |
      | job\_title          |       |
      | pay\_rate           |       |
      | pay\_period         |       |
      | pay\_frequency      |       |
      | employment\_type    |       |
      | effective\_date     |       |
      | remote\_data        |       |
      | custom\_fields      |       |
      | integration\_fields |       |
    </Accordion>

    <Accordion title="Groups">
      | Field               | Notes |
      | ------------------- | ----- |
      | id                  |       |
      | remote\_id          |       |
      | changed\_at         |       |
      | remote\_deleted\_at |       |
      | name                |       |
      | type                |       |
    </Accordion>

    <Accordion title="Time Off Balances">
      | Field               | Notes |
      | ------------------- | ----- |
      | id                  |       |
      | remote\_id          |       |
      | changed\_at         |       |
      | remote\_deleted\_at |       |
      | employee\_id        |       |
      | type\_id            |       |
      | balance             |       |
      | balance\_unit       |       |
      | used                |       |
      | used\_unit          |       |
      | remote\_data        |       |
    </Accordion>

    <Accordion title="Employee <> Group">
      | Field               | Notes |
      | ------------------- | ----- |
      | employee\_id        |       |
      | team\_id            |       |
      | id                  |       |
      | changed\_at         |       |
      | remote\_deleted\_at |       |
    </Accordion>
  </Tab>

  <Tab title="Actions">
    <Accordion title="Create employee">
      | Input Field             | Notes |
      | ----------------------- | ----- |
      | first\_name             |       |
      | last\_name              |       |
      | work\_email             |       |
      | gender                  |       |
      | job\_title              |       |
      | home\_address.street\_1 |       |
      | home\_address.city      |       |
      | home\_address.state     |       |
      | home\_address.zip\_code |       |
      | date\_of\_birth         |       |
      | mobile\_phone\_number   |       |
      | start\_date             |       |
      | location\_id            |       |
    </Accordion>

    <Accordion title="Create employee (v2)">
      <Info>For detailed information about [creating employees with form](/hris/implementation-guide/create-employee), please see the [**Create Employee with Form** tab](#create-employee-with-form) above.</Info>

      | Input Field          | Notes |
      | -------------------- | ----- |
      | staffing\_entity\_id |       |
      | properties           |       |
    </Accordion>
  </Tab>

  <Tab title="Features">
    | Feature               | Notes |
    | --------------------- | ----- |
    | Connection Guide      |       |
    | API Passthrough       |       |
    | Scope Testing         |       |
    | Per Model Tests       |       |
    | Delta Syncs           |       |
    | Group Types           |       |
    | DEPARTMENT            |       |
    | Custom Field Explorer |       |
    | Employees             |       |
    | Employments           |       |
  </Tab>

  <Tab title="Create Employee with Form">
    <Info>
      Some **optional** form fields are referencing the following data models:

      * Employees

      Consider enabling these in your [scope configuration](/hris/features/scopes).
    </Info>

    <ResponseField name="person" type="object" required>
      **Person**

      <Expandable title="properties">
        <ResponseField name="firstName" type="text" required>**First Name**<br />
        The first name of the employee<br />
        Unified field: `first_name`</ResponseField>
        <ResponseField name="lastName" type="text" required>**Last Name**<br />
        The last name of the employee<br />
        Unified field: `last_name`</ResponseField>
        <ResponseField name="dateOfBirth" type="date" required>**Date of Birth**<br />
        Unified field: `date_of_birth`</ResponseField>
        <ResponseField name="middleName" type="text">**Middle Name**</ResponseField>
        <ResponseField name="gender" type="single_select">**Gender**<br />
        The gender of the employee<br />
        Unified field: `gender`</ResponseField>
        <ResponseField name="employeeStatus" type="single_select">**Employee Status**</ResponseField>
        <ResponseField name="leaveStartDate" type="date">**Leave Start Date**</ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="communication" type="object">
      **Communication**

      <Expandable title="properties">
        <ResponseField name="addresses" type="array">
          **Addresses**

          <Expandable title="items">
            <ResponseField name="useCode" type="single_select" required>**Use Code**</ResponseField>
            <ResponseField name="addressLine" type="text" required>**Address Line**</ResponseField>
            <ResponseField name="city" type="text" required>**City**</ResponseField>
            <ResponseField name="state" type="single_select" required>**State**</ResponseField>
            <ResponseField name="postalCode" type="text" required>**Postal Code**</ResponseField>
          </Expandable>
        </ResponseField>

        <ResponseField name="emails" type="array">
          **Emails**

          <Expandable title="items">
            <ResponseField name="emailAddress" type="text" required>**Email Address**</ResponseField>
            <ResponseField name="useCode" type="single_select" required>**Use Code**</ResponseField>
          </Expandable>
        </ResponseField>

        <ResponseField name="phones" type="array">
          **Phones**

          <Expandable title="items">
            <ResponseField name="number" type="text" required>**Mobile Phone Number**<br />
            The mobile phone number of the employee<br />
            Unified field: `mobile_phone_number`</ResponseField>
            <ResponseField name="useCode" type="single_select" required>**Use Code**</ResponseField>
          </Expandable>
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="position" type="object">
      **Position**

      <Expandable title="properties">
        <ResponseField name="workersCompensationCode" type="single_select">**Workers Compensation Code**</ResponseField>
        <ResponseField name="jobFunctionID" type="single_select">**Job Function**</ResponseField>
        <ResponseField name="jobTitle" type="text">**Job Title**</ResponseField>
        <ResponseField name="isMinister" type="single_select">**Is Minister?**</ResponseField>
        <ResponseField name="isFicaExempt" type="single_select">**Is Fica Exempt?**</ResponseField>
        <ResponseField name="supervisorID" type="single_select">**Supervisor**<br />
        References `/v1/hris/employees?remote_model=employee`</ResponseField>
        <ResponseField name="departmentID" type="single_select">**Department**</ResponseField>
        <ResponseField name="isExemptFromSocialSecurityIndicator" type="single_select">**Is Exempt From Social Security Indicator?**</ResponseField>
        <ResponseField name="jobCosting" type="multi_select">**Job Costing**</ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="employment" type="object">
      **Employment**

      <Expandable title="properties">
        <ResponseField name="isUnionMember" type="single_select">**Is Union Member?**</ResponseField>
        <ResponseField name="employeeAgreementCategory" type="single_select">**Employee Agreement Category**</ResponseField>
        <ResponseField name="ownerStatus" type="single_select">**Owner Status**</ResponseField>
        <ResponseField name="jobDuty" type="single_select">**Job Duty**</ResponseField>
        <ResponseField name="jobCategoryID" type="single_select">**Job Category**</ResponseField>
        <ResponseField name="willWorkMultiStates" type="single_select">**Will Work Multi States?**</ResponseField>
        <ResponseField name="willWorkInternational" type="single_select">**Will Work International?**</ResponseField>
        <ResponseField name="primaryInternationalCountry" type="text">**Primary International Country**</ResponseField>
        <ResponseField name="willTravelInternational" type="single_select">**Will Travel International?**</ResponseField>
        <ResponseField name="hireDate" type="date">**Hire Date**</ResponseField>
        <ResponseField name="insperityHireDate" type="date">**Insperity Hire Date**</ResponseField>
        <ResponseField name="ptoEffectiveDate" type="date">**PTO Effective Date**</ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="compensation" type="object">
      **Compensation**

      <Expandable title="properties">
        <ResponseField name="classification" type="single_select">**Classification**</ResponseField>
        <ResponseField name="temporaryIndicator" type="single_select">**Temporary Indicator**</ResponseField>
        <ResponseField name="temporaryStatusEndDate" type="date">**Temporary Status End Date**</ResponseField>
        <ResponseField name="isExemptFromOvertime" type="single_select">**Is Exempt From Overtime?**</ResponseField>
        <ResponseField name="isPaidTips" type="single_select">**Is Paid Tips?**</ResponseField>
        <ResponseField name="isPaidPiecework" type="single_select">**Is Paid Piecework?**</ResponseField>
        <ResponseField name="pieceWorkBasis" type="single_select">**Piece Work Basis**</ResponseField>
        <ResponseField name="pieceWorkRate" type="text">**Piece Work Rate**</ResponseField>
        <ResponseField name="isPaidSalary" type="single_select">**Is Paid Salary?**</ResponseField>
        <ResponseField name="salaryBasis" type="single_select">**Salary Basis**</ResponseField>
        <ResponseField name="salaryRate" type="text">**Salary Rate**</ResponseField>
        <ResponseField name="isPaidHourly" type="single_select">**Is Paid Hourly?**</ResponseField>
        <ResponseField name="hourlyrate" type="text">**Hourly Rate**</ResponseField>
        <ResponseField name="isPaidCommission" type="single_select">**Is Paid Commission?**</ResponseField>
        <ResponseField name="isCommissionDraw" type="single_select">**Is Commission Draw?**</ResponseField>
        <ResponseField name="commissionDrawRate" type="text">**Commission Draw Rate**</ResponseField>
        <ResponseField name="isAllowanceProvided" type="single_select">**Is Allowance Provided?**</ResponseField>
        <ResponseField name="allowanceCarAmount" type="text">**Allowance Car Amount**</ResponseField>
        <ResponseField name="allowanceCarPayFrequency" type="single_select">**Allowance Car Pay Frequency**</ResponseField>
        <ResponseField name="allowanceOther1Amount" type="text">**Allowance Other 1 Amount**</ResponseField>
        <ResponseField name="allowanceOther1PayFrequencyAllowanceFrequency" type="single_select">**Allowance Other 1 Pay Frequency Allowance Frequency**</ResponseField>
        <ResponseField name="allowanceOther1Description" type="text">**Allowance Other 1 Description**</ResponseField>
        <ResponseField name="allowanceOther2Amount" type="text">**Allowance Other 2 Amount**</ResponseField>
        <ResponseField name="allowanceOther2PayFrequencyAllowanceFrequency" type="single_select">**Allowance Other 2 Pay Frequency Allowance Frequency**</ResponseField>
        <ResponseField name="allowanceOther2Description" type="text">**Allowance Other 2 Description**</ResponseField>
      </Expandable>
    </ResponseField>
  </Tab>
</Tabs>
