> For the complete documentation index, see [llms.txt](https://docs.harmony.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.harmony.io/integrations/hris/shapes.md).

# Shapes

Shapes is an AI-native HR platform covering people directory, time off, attendance, workflows, performance, analytics, surveys, and documents. Connecting Shapes to Harmony syncs employee data and approved time off into Harmony, so IT provisioning, offboarding, and routing can be driven by the same source of truth HR uses.

#### What the Shapes integration enables

| Capability               | Description                                                            |
| ------------------------ | ---------------------------------------------------------------------- |
| Employee Data Sync       | Sync employee profiles, job data, and organizational structure         |
| Automated Onboarding     | Trigger IT provisioning when new employees are added in Shapes         |
| Offboarding Workflows    | Revoke access and reclaim assets when employees are terminated         |
| Department-Based Routing | Route IT requests based on employee department and reporting line      |
| Time-Off Awareness       | Ingest approved time off so routing and assignments respect who is out |

#### Prerequisites

* **Shapes Administrator Access**: Admin role with permission to generate API tokens
* **Shapes Subscription**: Active Shapes account for your organization
* **Harmony Account**: Active Harmony workspace

#### Connect Shapes to Harmony

**Step 1: Generate an API Token in Shapes**

1. Log in to Shapes at <https://shapes.co>
2. Click your profile and open **My Settings**
3. Select **API tokens**
4. Click **Create token**
5. Name it `Harmony Integration` and click **Generate**
6. Copy the **Refresh token** - it will not be shown again

**Step 2: Navigate to Integrations**

1. Log in to your Harmony dashboard
2. Go to **Settings** > **Integrations**
3. Find **Shapes** under **HRIS** and click **Connect**

**Step 3: Enter API Credentials**

1. Paste your **Refresh token**
2. Click **Connect**

{% hint style="info" %}
Harmony rotates the Shapes refresh token automatically as it's used. You do not need to regenerate or update the token unless you revoke it in Shapes.
{% endhint %}

#### What Harmony Syncs

**From Shapes:**

* Employee profiles (first name, last name, email)
* Job information (title, department, level)
* Employment status and contract type
* Manager relationships and reporting hierarchy
* Work location
* Employment dates (hire date, termination date)
* Approved time off - synced on a 14-day rolling window (7 days back and 7 days forward from today)

#### Use Cases

<details>

<summary>Automated New Hire Provisioning</summary>

Trigger complete IT setup when HR adds new employees to Shapes

</details>

<details>

<summary>Role Change Management</summary>

Automatically adjust access when employees change roles, departments, or managers

</details>

<details>

<summary>Seamless Offboarding</summary>

Automate access revocation and equipment collection when employees are terminated in Shapes

</details>

<details>

<summary>Time-Off Aware Routing</summary>

Route IT tickets based on employee availability from Shapes time-off data. Harmony syncs approved bookings within a 14-day rolling window, covering 7 days back and 7 days ahead from the current date, so assignments and routing always reflect up-to-date availability.

</details>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.harmony.io/integrations/hris/shapes.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.