Authorization
When you add a KnowBe4 card to a flow for the first time, Okta Workflows prompts you to configure the connection. This connection links to your KnowBe4 account and saves your account information, so you can reuse the connection for future KnowBe4 flows.
You can create multiple unique connections and manage them from the Connections page in the Okta Workflows Console.
Before you begin
You need the following elements to create a connection to a KnowBe4 account:
-
Your account region. After you sign in to your KnowBe4 account, your account region is the first part of the browser URL, for example: https://{region}.knowbe4.com/
-
A KnowBe4 API token. In your KnowBe4 account, go to to find or create an API token for your KnowBe4 account.
The KnowBe4 connector supports only the KnowBe4 Reporting API.
Procedure
To create a KnowBe4 connection in Okta Workflows, complete the following steps in your Workflows Console.
- Open the Connections tab in the Workflows Console or open a KnowBe4 card.
- Click New Connection.
- Select the KnowBe4 icon in the New Connection dialog.
- Enter a connection Name. A unique name is useful if you plan to create multiple connections to share with your team.
- Enter a connection Description. This is useful to have more information regarding your connection. This step is optional.
- In the Region dropdown, select the region for your account.
- Enter your KnowBe4 API token in the API Token field.
- Click Create.
Known issues and limitations
Use of the Reporting API is limited to 2,000 requests per day plus the number of licensed users on your account. The API daily limit starts approximately twenty-four (24) hours after the first API request. After you reach the daily limit, the KnowBe4 connector card returns a 429 (Too Many Requests) error.