Skip to main content
KnowBe4 requires a Platinum, Diamond or SAT Advanced subscription for the User Event API Management Console, where keys are created. The User Event API allows 10 calls per licensed user a day. A User Event API key works only with the user event actions.

​
Find your region

Your region is the KnowBe4 data center that hosts your account. StackOne uses it to pick the User Event API address for your account.

  • Look at the address in your browser while you are signed in to the KnowBe4 console.
  • Format: {subdomain}.knowbe4.com
  • Example: eu.knowbe4.com
  • training.knowbe4.com is US (training.knowbe4.com)
  • eu.knowbe4.com is EU (eu.knowbe4.com)
  • ca.knowbe4.com is Canada (ca.knowbe4.com)
  • uk.knowbe4.com is UK (uk.knowbe4.com)
  • de.knowbe4.com is Germany (de.knowbe4.com)
  • Select the matching option in the Region field in StackOne Hub.

​
Create a User Event API key

A User Event API key lets StackOne push security events into your users’ KnowBe4 timelines and read them back. It is separate from the Product API token and the Reporting API token.

1

Sign in to KnowBe4

Sign in to your KnowBe4 console as an admin, at the address for your region.

  • Outside the US, use your region’s address instead, for example https://eu.knowbe4.com.
  • Click your email address at the top right of the page and select Account Settings.
  • Navigate to Account Integrations > API.
2

Open the User Event API Management Console

In the User Event API section, open the User Event API Management Console, then open its API Key tab.

3

Create and copy the key

Enter a name such as StackOne Integration and click Create API Key. KnowBe4 shows the key in a pop-up.

  • KnowBe4 shows the key once. Later you can see only its last 10 digits, so a lost key needs a new one.
  • Copy the User Event API Key across.

​
Replace or revoke the key

Manage the key on the API Key tab of the User Event API Management Console.

  • To revoke it, click the trash can icon next to the key. The connection stops working.
  • KnowBe4 keys expire after five years at most. Create a new one before then and copy the new User Event API Key across.
1

Connect

  • Click Connect.
  • If applicable, the provider will redirect you to a sign-in or authorization page. Complete the provider’s authorization flow.
  • Once authorization is successful, you will see a confirmation popup.
2

Use Actions

Connect an AI platform to the linked account’s actions. See AI Platforms.Other ways to call actions are listed in Protocols & SDKs.