Skip to content

Okta Triggers and Actions in HappyFox Workflows

Views
5
Last updated

This article describes the triggers and actions available when you connect Okta to HappyFox Workflows, and lists the IT operations you can automate with this integration.

Applicable Plans: ✔️ Basic ✔️ Team ✔️ Pro ✔️ Enterprise


Triggers

Okta triggers allow HappyFox Workflows to start automatically when identity or access events occur in your Okta organisation. Use these triggers to respond to user lifecycle changes without manual intervention.

Trigger

When it fires

User Activated

A user account in Okta is activated.

User Profile Updated

A user's profile in Okta is updated, such as a change to their name, email, or department.

User Deactivated

A user account in Okta is deactivated.

User Account Auto-Locked

A user account is automatically locked in Okta, typically due to repeated failed login attempts.

User Added to Group

A user is added to an Okta group.

 

Triggers

Triggers start a workflow automatically when a specific event happens in Okta. They have no configurable input fields — the workflow fires as soon as the matching Okta webhook event arrives. You can narrow which events actually start an execution by adding conditions to the trigger step in the workflow builder.

All Okta triggers fetch the affected user's full profile from the Okta API at the time the event fires and make the following fields available to subsequent steps:

Common trigger output fields (available in all Okta triggers)

Field Description
id The Okta user's unique ID.
status The user's current status (for example, ACTIVE, DEPROVISIONED, SUSPENDED, LOCKED_OUT).
created Timestamp when the Okta account was created.
last_login Timestamp of the user's most recent sign-in.
login The user's Okta login name (typically their email).
email The user's primary email address.
firstName The user's first name.
lastName The user's last name.
Any other Okta profile field Additional profile attributes configured in your Okta tenant are also passed through.

User Lifecycle Triggers

User Activated

Fires when an Okta user account transitions to the ACTIVE state — for example, when an admin activates a newly staged account or reactivates a deprovisioned user.

What fires it: Okta user.lifecycle.activate event received via webhook.

Data available: All common trigger output fields listed above, reflecting the user's profile and status at the moment of activation.

User Deactivated

Fires when an Okta user account is deactivated and moves to the DEPROVISIONED state, revoking all sessions and access.

What fires it: Okta user.lifecycle.deactivate event received via webhook.

Data available: All common trigger output fields listed above, reflecting the user's profile and status at the moment of deactivation.

User Profile Updated

Fires when any field on an Okta user's profile is changed — for example, a name, email, job title, or department update.

What fires it: Okta user.account.update_profile event received via webhook.

Data available: All common trigger output fields listed above, reflecting the updated profile values at the time of the change.

Tip: Use workflow conditions on this trigger to react only to specific field changes — for example, firing only when department changes to a certain value.

User Account Auto-Locked

Fires when Okta automatically locks a user account after too many consecutive failed sign-in attempts. Unlike the other user triggers, the locked-out user is identified from the event's actor field — because the user is the one triggering the lock by attempting to sign in — not from the target list.

What fires it: Okta user.account.lock event received via webhook.

Data available: All common trigger output fields listed above, reflecting the profile of the user who was locked out.

Group Triggers

User Added to Group

Fires when a user is added to an Okta group. In addition to the standard user profile fields, the trigger also includes data about the group the user was added to.

What fires it: Okta group.user_membership.add event received via webhook.

Data available: All common trigger output fields listed above, plus:

Field Description
group_<group_name> An object containing the full group record for the group the user was just added to. The key uses the group name with spaces replaced by underscores (for example, group_IT_Support for a group named "IT Support"). Includes the group's id, type, profile, and other Okta group attributes.

Note: If multiple users and groups appear in the same Okta event batch, a user's trigger data may include groups they were already a member of, not just the newly added group. This is a known edge case in the Okta event format and is unlikely to affect most single-user workflows.

 


Actions

Okta actions let you manage user accounts, security settings, group membership, and app assignments directly from a workflow step.

User lifecycle

Action

What it does

Get user by login name

Retrieves an Okta user's profile details using their login name, for use in subsequent workflow steps.

Activate user

Activates a deactivated Okta user account.

Reactivate user

Reactivates a previously deactivated user account that has already been through the activation process.

Deactivate user

Deactivates an Okta user account, preventing login without deleting the account.

Suspend user

Temporarily suspends an Okta user account. The account remains in Okta but the user cannot log in.

Unsuspend user

Removes the suspension from an Okta user account, restoring login access.

Create User

Creates a new user account in Okta.

User security

Action

What it does

Unlock user

Unlocks an Okta user account that has been locked due to failed login attempts.

Reset password for user

Sends a password reset email to the user.

Expire password for user

Forces a user's password to expire immediately, requiring them to set a new one on next login.

Reset user factors

Resets all multi-factor authentication (MFA) factors enrolled for the user.

Clear user sessions

Terminates all active sessions for the user, signing them out of all connected apps immediately.

Group management

Action

What it does

Add user to group

Adds an Okta user to a specified Okta group.

Remove user from group

Removes an Okta user from a specified Okta group.

App access

Action

What it does

Assign app to user

Grants a user access to a specified app in Okta.

Revoke app for user

Removes a user's access to a specified app in Okta.

 

See Okta User Lifecycle Actions in HappyFox Workflows to learn more on how to configure each action


Use cases

Automated employee onboarding from a support ticket: When an IT onboarding ticket is created in HappyFox Help Desk, automatically create the new user's Okta account, add them to the appropriate group, and assign them access to the apps they need — eliminating manual provisioning steps and reducing the time between a new hire's start date and their first login.

Account lockout self-service resolution: When Okta fires a User Account Auto-Locked trigger, automatically create a ticket in HappyFox Help Desk and notify the agent assigned to IT support — so lockout incidents are tracked, prioritised, and resolved without the user needing to call the help desk.

Employee offboarding on ticket closure: When an offboarding ticket is resolved in HappyFox Help Desk, automatically deactivate the departing employee's Okta account, remove them from all groups, and revoke their app access — ensuring access is terminated consistently without relying on manual checklists.

MFA reset from an IT support ticket: When an agent resolves a ticket requesting an MFA reset, automatically trigger the Reset user factors action in Okta — removing the manual step of switching between HappyFox Help Desk and the Okta admin console to complete the request.

Profile change notification to IT: When Okta fires a User Profile Updated trigger — for example, when a user's department or manager changes — automatically create or update a HappyFox Help Desk ticket to notify the IT team, so they can review whether the user's group membership and app access still match their new role.

Temporary access suspension for security incidents: When a security-related ticket is raised — such as a report of a compromised account or suspicious login activity — automatically suspend the user's Okta account while the investigation is underway, and reactivate it once the ticket is resolved.