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

# Leapsome

> Sync review and goal data from Leapsome for performance and development analytics.

Please execute the following steps to provision a dedicated Content API token for our analytics integration. Leapsome's Content API is a **one-way (read-only) integration** used to extract data from your Leapsome workspace.

### Important Note

The Content API token must be created by a user with administrator access in Leapsome. The token is only displayed *once* at the time of creation, so make sure to copy it immediately and store it securely until you hand it off through our portal.

### Phase 1: Generate a Content API Token

#### Navigate to API Access

* **Path:** **Settings** → **Integrations and imports** → **API access**

#### Create the API Secret

* **Action:** Click **"Create API Secret"**.
* **Name:** `Human Intelligence Analytics Integration`

#### Grant the Required Scopes

<Warning>
  **Important:** When configuring the API Secret, the token **must** be granted scopes for *Goals, Reviews, Users, Timetracking, Payroll, Work Locations, Absences,* and *Feedback*. The integration will not function correctly if any of these scopes are missing.
</Warning>

#### Copy the Generated Token

Once created, the token will appear directly above the **"Create API Secret"** button. Copy it immediately — it will not be shown again.

| Required Scope | Purpose                                                                  |
| -------------- | ------------------------------------------------------------------------ |
| Goals          | Required for OKR and goal-progress analytics.                            |
| Reviews        | Required to pull performance review scores and responses.                |
| Users          | Required for headcount, org structure, and joining other data to people. |
| Timetracking   | Required for utilization and time-allocation analysis.                   |
| Payroll        | Required for compensation and payroll cost analytics.                    |
| Work Locations | Required for location-based workforce reporting.                         |
| Absences       | Required for absence, leave, and PTO analytics.                          |
| Feedback       | Required for cultural and sentiment analysis.                            |

### Phase 2: Review Available Data (Optional)

From the same **API access** page, clicking **"Leapsome API"** opens Leapsome's Content API documentation, where you can review the exact data points available from the Reviews, Goals, and other enabled modules.

### Phase 3: Handover

Please securely transmit your **API Key** (the Content API Secret generated in Phase 1) through our integration portal.
