---
title: 15Five Integration
slug: UKSwhlAdx1oJMW_Mitnri
docTags: 
createdAt: 2024-05-01T01:04:56.652Z
---

:::hint{type="warning"}
This feature is currently in Alpha. Be one of the first customers to try it! Please share any feedback with the ChartHop team. 

### How to setup a Alpha Feature

1. Contact [ChartHop support](mailto\:support@charthop.com) or your CSM if you have one. They can activate the feature for you. 
2. Read below for setup instructions and context on how the feature will work.
:::

The 15Five integration is a one way sync that allows the syncing of forms and reviews from 15Five into ChartHop. 

## What information is synced from 15Five

The 15Five app will import and sync the following pieces of information:

1. 15Five Review Cycles → ChartHop Forms & Performance Reviews

Imports will align to the following details:

- Competency questions in 15Five are imported as numeric scale fields with Manager Only access in ChartHop. If the competency scale was changed, it will create a new field.
- All other questions are mapped as fields in the form, and will have a corresponding share access that most closely aligns from 15five. 
- All forms are imported as “Archived”
- You can identify forms and fields and reviews created by the app because they will list "15five" as the "Created by".
- Changing the name of the form or review in ChartHop will break a continuous sync.

:::hint{type="info"}
If you would like any additional or different information synced from 15Five, please let the ChartHop team know. 
:::



## How to setup the 15Five App

1. Go to **Apps & Bundles > Apps**
2. Navigate to the **Other Available Apps** and search for **15Five**
3. Install the **App** and add in your **API key from 15Five **
   1. To generate an [API key in 15Five:](https://success.15five.com/hc/en-us/articles/360002699631-API)
      - Click the **Settings gear** in the bottom-left corner of the 15Five account
      - Select **Integrations** from the dropdown menu
      - Click **Enable** to the right of the Public API option
      - Once enabled, you'll land on the **Company API keys** page
      - Click **Create new key**
      - Add a short name for the API key (something identifiable server-side)
      - Copy the **access token** and use it to authenticate

## Review Cycles

[Performance reviews](docId\:pgai8TVrVYWmDcEAnerwg) will be created for every Best-Self Review cycle in 15Five. Separate ChartHop [Forms](docId\:QR76GaDOskC1RlC_S0jes) will be created for each direction or type of review. 

For example — A 360 review named `2023 Q1 Review Cycle` will contain forms for each direction of feedback: 

- 2023 Q1 Review Cycle - Self
- 2023 Q1 Review Cycle - Downward
- 2023 Q1 Review Cycle - Upward
- 2023 Q1 Review Cycle - Peer

Not all review types are required. A 15Five cycle can include any combination of Self, Manager, Peer, and Upward reviews. Only the review types that were enabled for a given cycle will produce corresponding forms in ChartHop. 

If you have multiple cycles in 15Five with similar names that you would like to combine in ChartHop list the name you would like to combine in the  **Condense Cycle Names** setting. For example, you would write `2024 Q3 Review Cycle` if you had 2 review in 15Five named: `2024 Q3 Review Cycle: Retail` & `2024 Q3 Review Cycle: Office` that you wanted to combine into one review called `2024 Q3 Review Cycle.`

**NOTE:** We will only import completed cycles, and forms and fields that have responses saved to them. For example, if a review is in DRAFT status, it will not sync over. We also won't sync over a question without responses. 

### Import ratings as fields

All Opinion Scale questions in 15Five will be imported as Numeric Scale questions in ChartHop. This includes standard opinion-scale questions as well as competency and company value rating questions. All fields will be imported with a sensitivity of `Manager Only` at this time. The fields will be named:

:::Paragraph{indent="1"}
**Label**: The question text, such as: "Rate \[Name]'s contribution to the company value: Always Be Learning & Growing"
**Code**: `fifteenfive` + `TheQuestionsFirstCharacters — e.g., fifteenfiveRateNamesContributionTo`
:::



:::hint{type="warning"}
Changing the code of the field will throw off the sync and cause an additional field to be created. 
:::



## How imported form responses will appear to employees

Imported form responses are not immediately visible to employees, but can be surfaced on [Custom profile tabs](docId\:Kiuev47LOf6QTLVjlujlr). 

Imported form responses will display **"Imported from 15Five"** on the form response.