Event hooks are outbound calls from Okta that trigger process flows within software systems. They are sent when specific events occur in the org and deliver information about the event. This article explains how a feature can be set up and implemented for notification purposes.

• Webhooks 
• Notification system
• Eligible events

1. Set Up a Webhook: Webhooks can be configured to receive notifications for specific events, such as application assignment errors or user lockouts.

   1. In the Admin Console, go to Workflow > Event Hooks.

   2. Click Create Event Hook.

   3. Complete these fields:

      • Endpoint URL: Enter the external service's endpoint URL where the event hook sends the request.
      • Event Hook name: Enter a unique name for the event hook.
      • Description: Optional. Enter the purpose and a description of the event hook.

   4. Optional. For enhanced security and to secure the communication channel between Okta and the external service, add authentication under Enhance security:

      • Authentication field: Enter the name of the authorization header.

      • Authentication secret: Enter the value that corresponds to the field name.

   5. Optional. To create custom proprietary headers for extra authorization security, click Add Field under Custom headers, and then complete these fields:

      • Field Name: Enter a name for the custom header.

      • Value: Enter a value for the field name.

   6. Click inside the text box under Select Events, and then select the events that should be added.

   7. Click Create hook & Continue to save the unverified event hook. 

2. Define the Events: Specify the events to monitor in Okta. This could include user lockouts or application assignment errors. To find the events eligible for this process, visit the Okta Event Types Catalog.

3. Create an Endpoint: Set up an endpoint URL in the receiving application that will listen for incoming webhook payloads from Okta. To do so, use the Admin Console from the Workflow > Event Hooks page. 

4. Receive and Process Data: Once the specified events trigger the webhook, the endpoint will receive the data/notifications.

Related References

• Event Types
• Event hooks
• Create an event hook