> ## 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.

# Square HRIS Integration

> Square connector for Kombo's HRIS API

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

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

## Guides and Resources

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

  <Card title="Sandbox Environment" icon="flask" href="https://developer.squareup.com/docs/devtools/sandbox/overview">
    Access the Square sandbox environment for testing and development.
  </Card>
</CardGroup>

## Supported Features & Coverage

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

    <Accordion title="Employees">
      | Field               | Notes                                                                                                                       |
      | ------------------- | --------------------------------------------------------------------------------------------------------------------------- |
      | id                  |                                                                                                                             |
      | remote\_id          |                                                                                                                             |
      | changed\_at         |                                                                                                                             |
      | remote\_deleted\_at |                                                                                                                             |
      | employee\_number    |                                                                                                                             |
      | first\_name         |                                                                                                                             |
      | last\_name          |                                                                                                                             |
      | job\_title          |                                                                                                                             |
      | work\_email         |                                                                                                                             |
      | employment\_status  |                                                                                                                             |
      | work\_location\_id  | Employees in Square can be assigned to multiple locations. We only return locations for employees assigned to one location. |
      | remote\_created\_at |                                                                                                                             |
      | custom\_fields      |                                                                                                                             |
      | integration\_fields |                                                                                                                             |
      | 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\_currency       |       |
    </Accordion>
  </Tab>

  <Tab title="Actions">
    <Accordion title="Create employee">
      <Note>
        Employees will always be created as inactive in Square. We are not assigning the job automatically, because the manager needs to specify salary and job information for the employment manually.
      </Note>

      | Input Field           | Notes |
      | --------------------- | ----- |
      | first\_name           |       |
      | last\_name            |       |
      | work\_email           |       |
      | mobile\_phone\_number |       |
      | location\_id          |       |
    </Accordion>
  </Tab>

  <Tab title="Features">
    | Feature          | Notes |
    | ---------------- | ----- |
    | Connection Guide |       |
    | Prerequisites    |       |
    | OAuth            |       |
  </Tab>
</Tabs>