Event Hooks

Event hooks are outbound calls from Okta that trigger process flows within your own software systems. They are sent when specific events occur in your orgThe Okta container that represents a real-world organization., and they deliver information about the event. Unlike inline hooks, event hooks are asynchronous and do not offer a way to execute the Okta process flow. After sending the call, the Okta process flow continues without waiting for a response from the called service.

To set up an event hook, you need to implement a web service with an Internet-accessible endpoint. It's your responsibility to arrange hosting of your code on a system external to Okta. Okta defines the REST API contract for the requests it sends to your custom code, as well as for the responses your custom code can send back.

Learn more about which events are eligible.

Add an Event Hook

After creating your external service, you need to tell Okta that it exists and enable it for a particular process flow.

  1. Select Workflow > Event Hooks in the Okta AdminAn abbreviation of administrator. This is the individual(s) who have access to the Okta Administrator Dashboard. They control the provisioning and deprovisioning of end users, the assigning of apps, the resetting of passwords, and the overall end user experience. Only administrators have the Administration button on the upper right side of the My Applications page. Console.
  2. Click Add Event Hook.
  3. Define the following attributes:

  4. Click Save & Continue. The event hook is now Active.


Verify Your Endpoint

After saving your event hook, you need to verify your endpoint. To understand how endpoint verification works, refer to One-Time Verification Request and Verifying an Event Hook.

  1. In the Verify Endpoint Ownership window, click Verify.
  2. If Okta successfully verifies the endpoint, it is listed as Active on the Event Hooks page.


  1. In the Verify Endpoint Ownership window, click Do this later.
  2. When you are ready to verify the endpoint, navigate to Workflow > Event Hooks.
  3. Click the event hook's Actions drop-down menu, and then select Verify.