Shapes

Sync Shapes people data and time off to automate HR-driven IT provisioning and lifecycle workflows

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

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.

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

Automated New Hire Provisioning

Trigger complete IT setup when HR adds new employees to Shapes

Role Change Management

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

Seamless Offboarding

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

Time-Off Aware Routing

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.