How to Resolve the First Connect to Your Apps Error in Okta Workflows

An error occurs when attempting to activate a flow in Okta Workflows because a required application connection is missing, unauthorized, deleted, or unavailable. Resolve this issue by identifying the affected cards, reauthorizing the connections, and ensuring the service account has the correct permissions. The following error message appears when attempting to activate the flow:

First connect to your apps

Review the following image for an example of the error message:

• Okta Identity Engine (OIE)
• Okta Classic Engine
• Okta Workflows

This error occurs because the workflow contains one or more cards that require a connection to an external application, and that connection is not fully established or authorized. 

How is the connection error resolved in Okta Workflows?

Identify the affected cards, review the application connector setup, ensure the correct privileges are granted, and reauthorize the connector by following these steps:

1. Identify any cards in the flow that display a warning icon or a message indicating a missing connection.
2. Review the application connector setup and confirm that the connection for each application is created and authorized.
3. Ensure the account (recommended service account) used has the appropriate admin privileges and that all necessary scopes have been granted.
4. If credentials or permissions were recently updated, reauthorize the connector and confirm default or custom scopes are used (as required).
5. Select the Save button and attempt to run the flow again.