Microsoft Entra ID
Governance

Create a lifecycle workflow - Microsoft Entra ID

In brief

The article now documents identity-verification onboarding templates, required verification profiles, template-specific trigger settings, and the distinction between enabling a workflow and enabling scheduled runs.

What Entra admins need to know

Administrators creating these workflows must select a profile with purpose `all` or `onboarding`; they can test workflows on demand before enabling scheduled processing.

This editorial summary was generated by AI from the documentation changes. Verify important details in the full Microsoft Learn article.

Documentation change

The comparison below shows only the changed extract. Use the full-page view for complete context.

[!INCLUDE Microsoft Entra ID Governance license]

  • An ID verification profile with purpose set to all or onboarding, if you use either identity-verification template (Preview). You can create a profile before you start or select Create new verification profile during workflow creation. For profile configuration, see Create an ID verification profile.

Create a lifecycle workflow by cloning an existing workflow in the Microsoft Entra admin center

You can use an existing workflow as the starting point for a new workflow. The clone option is available only in the Microsoft Entra admin center.

Create a lifecycle workflow by using a template in the Microsoft Entra admin center

If you're usingUse a built-in template as the Microsoft Entra admin center to createstarting point for a workflow, you canand customize existing templatesit to meet your organization's needs. TheseFor available templates include one for common pre-hire scenarios.and their default settings, see Lifecycle Workflows templates.

To create a workflow based on a template:

  1. On the Choose a workflow page, select the workflow template that you want to use.

    For identity-verification onboarding, select Pre-hire identity verification initiation (Preview) or New Hire employee onboarding with identity verification (Preview). See Lifecycle Workflows templates.

    :::image type="content" source="media/create-lifecycle-workflow/templates-list.png" alt-text="Screenshot of a list of lifecyclethe workflow templates.template gallery, including the two identity-verification templates in preview." lightbox="media/create-lifecycle-workflow/templates-list.png":::

  2. On the Basics tab, enter a unique display name, description, and administrative scope for the workflow, and thenworkflow.

    If you selected either identity-verification template, also select Trigger type on this tab. When you're finished, select Next.

    :::image type="content" source="media/create-lifecycle-workflow/template-basics.png" alt-text="Screenshot of basic information about a workflow template.":::

  3. On the Configure scope tab, configure the execution conditions for the workflow. For other templates, also select the trigger type and execution conditions to be used foron this workflow.tab. For more information on what you can configure, see Execution conditions.

  4. Under Rule, enter values for Property, Operator, and Value. The following screenshot gives an example of a rule being set up for a sales department. For a full list of user properties that lifecycle workflows support, see Supported user properties and query parameters.

    :::image type="content" source="media/create-lifecycle-workflow/template-syntax.png" alt-text="Screenshot of workflow rule syntax.":::

  5. If you selected either identity-verification template, on the Select identity verification profile tab, select a profile from Verified ID Profile. If you need a new profile, select Create new verification profile. The profile's purpose must be set to all or onboarding. Select Next: Review tasks.

    For other templates, skip this step and continue to Review tasks.

    :::image type="content" source="media/create-lifecycle-workflow/select-identity-verification-profile.png" alt-text="Screenshot of the identity verification profile selection tab, with the Verified ID Profile dropdown and Create new verification profile link." lightbox="media/create-lifecycle-workflow/select-identity-verification-profile.png":::

  6. On the Review tasks tab, you can add a task to the template by selecting Add task. To enable an existing task on the list, select Enable. To disable a task, select Disable. To remove a task from the template, select Remove.

    For identity-verification tasks, select or change the profile on the workflow's Select identity verification profile tab, not in the task settings. For task settings and email requirements, see Lifecycle workflow tasks.

    When you're finished with tasks for your workflow, select Next: Review and create.

    :::image type="content" source="media/create-lifecycle-workflow/template-tasks.png" alt-text="Screenshot of adding tasks to templates.":::

  7. On the Review and create tab, review the workflow's settings. You can also choose whether or notLeave the scheduling checkbox cleared to test the workflow before automatic processing begins. Select it when you're ready to enable the schedule for the workflow.scheduled runs. Select Create to create the workflow.

    :::image type="content" source="media/create-lifecycle-workflow/template-review.png" alt-text="Screenshot of reviewing and creating a workflow.":::

Create a lifecycle workflow by using Microsoft Graph

To create a lifecycle workflow by using the Microsoft Graph API, see Create workflow.

Next steps

  • Manage a workflow's properties

    For API creation, explicitly set isEnabled and isSchedulingEnabled for the intended run mode. The values you set control workflow execution and scheduling; don't assume the admin center's checkbox defaults apply to an API request.

    The three Preview tasks used by the two identity-verification templates are available only in Microsoft Graph /beta, not /v1.0. To create a workflow that includes these tasks, see Create workflow (beta). For task definitions and arguments, see Lifecycle workflow tasks.

    Related content

Daily Entra.News

Get daily email updates

Get a concise summary of the latest Microsoft Entra updates delivered straight to your inbox.

Loading the secure signup form…