Data Integration Guide - KnowBe4 KMSAT Reporting

- Create a Reporting API Token
- Enter the values into Unify

🔒  Create a Reporting API Token

1. From your KSAT console, click your email address at the top-right corner of the page and select Account Settings.

2. Navigate to Account Integrations > API.

3. Under Reporting API, click the Enable Report API Access check box.

4. Click Reporting API. The Reporting API subtab will open.

5. At the top-right corner of the Reporting API subtab, click + Create New API Token.

6. Fill out the fields on the Create New API Token page. For more information, see the screenshot and list below:

   1. Name: In this field, enter a descriptive name for this API token.

   2. Status: Enable or disable the API token.

7. Click Create Token. The Reporting API Token pop-up window will open.

8. Click the Reporting API token to copy the token. Make sure to save your copied API token somewhere that you can easily access. After you close this window, you will not be able to view this token again.

9. Click OK.

🛠️ Enter the values into Unify

From the administrative view in Unify:

1. Select Integrations.

2. Find Knowbe4 KMSAT Client and click +Add.

3. Name the integration appropriately and choose the Pull from remote API option.

4. Click Add Integration.

5. Enter the previously generated API Key and Host:

   1. Accounts on the US server (located at training.knowbe4.com) must use the Base URL of us.api.knowbe4.com.

   2. Accounts on the EU server (located at eu.knowbe4.com) must use eu.api.knowbe4.com.

   3. Accounts on the CA server (located at ca.knowbe4.com) must use ca.api.knowbe4.com.

   4. Accounts on the UK server (located at uk.knowbe4.com) must use uk.api.knowbe4.com.

   5. Accounts on the DE server (located at de.knowbe4.com) must use de.api.knowbe4.com.

6. Click Save.

✅ Permissions 

Require further assistance? Please submit a support request here.