Introduction

You can trigger Torii automation from an Okta Event Hook, such as when an employee is activated or created in Okta. For more information about Torii Webhook Triggers, see the Custom (Webhook) Trigger article. This guide will walk you through the process of setting up a workflow in Torii that reacts to Okta events using a Custom Webhook trigger.

Step-by-Step Instructions

Create a New Workflow in Torii

1. Navigate to the Torii workflows page: Log in to Torii and go to the "Workflows" section.
2. Click "New Workflow": Select the "From scratch" option.
3. Select "Custom trigger (webhook)": Choose this trigger type and click "Next."
4. Configure the trigger: Provide a meaningful description for your trigger, e.g., "Okta User Created Event."
5. Configure the trigger: In the "Webhook type" dropdown, select "Okta event hook."
6. Copy the Webhook URL address: This will be needed for configuring Okta.

Configure Event Hooks in Okta

4. Access the Okta Admin Console: Open the Okta admin console and navigate to the "Event Hooks" page.
5. Create a new Event Hook: Click "Create Event Hook."
6. Add Event Hook Endpoint:
   • Paste the "Webhook URL address" copied from Torii into the "URL" field.
   • In the “Subscribe to events” field, add the event that you want to trigger the workflow (e.g., "User created").
   • Click “Save & Continue.”
7. Verify the Event Hook: Click "Verify." Once verified, the webhook is successfully created, and Okta events will now trigger the workflow in Torii.
   

Send a Test Event from Okta to Torii

1. Return to Torii: Navigate back to the Workflow trigger configuration in Torii and click "Test trigger."
2. Preview the Event Hook in Okta:
   • In the Okta admin console, go to the Event Hooks page.
   • Locate the configured event hook and click "Actions → Preview."
     
3. Select Event Type: Choose the desired event type and one event from the System Log Event.
   
4. Deliver the Request: Click "Deliver Request" to send the test event.

💡 Important Note: Torii requires at least one past event to build personalization tokens for future events. The event sent from the Okta preview fulfills this requirement.

Configure Torii Trigger Payload for Personalization Tokens

1. View Received Payload: Return to the Workflow trigger configuration pane in Torii. Confirm that the payload has been received.
   
   
   
2. Add a Workflow Action: On the workflow canvas, add a new action, such as "Send Email."
3. Use Payload Data: Populate the workflow action fields using data from the payload.
   
   You can use the email field from the payload wherever there is a Torii action that accepts a user dropdown.
   

With these steps, your Torii workflow is now configured to trigger from Okta Event Hooks. This allows seamless automation based on Okta events.