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
alloronboarding, 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:
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 workflowtemplates.template gallery, including the two identity-verification templates in preview." lightbox="media/create-lifecycle-workflow/templates-list.png":::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.":::
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 thisworkflow.tab. For more information on what you can configure, see Execution conditions.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.":::
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
alloronboarding. 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":::
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.":::
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 enablethe 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 propertiesFor API creation, explicitly set
isEnabledandisSchedulingEnabledfor 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
- Manage workflow versions
@@ -1,10 +1,13 @@ --- title: Create a lifecycle workflow - Microsoft Entra ID-description: This article guides you in creating a lifecycle workflow.+description: Create a lifecycle workflow from a template, clone an existing workflow, or use Microsoft Graph. Configure a profile for identity verification templates.+author: rogulati+ms.author: rogulati ms.subservice: lifecycle-workflows ms.topic: how-to-ms.date: 08/21/2026-ms.custom: template-how-to+ms.date: 11/03/2026+ms.custom: template-how-to, msecd-doc-authoring-1026+ai-usage: ai-assisted #Customer Intent: As an IT admin, I want to create a lifecycle workflow so that I can automate identity lifecycle processes in my organization. --- @@ -21,6 +24,8 @@ In the Microsoft Entra admin center, you can create and customize workflows for [!INCLUDE [Microsoft Entra ID Governance license](../includes/entra-entra-governance-license.md)] +- 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](../verified-id/how-to-create-id-verification-profile.md).+ ## 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.@@ -51,8 +56,7 @@ To customize the workflow before you create it, select the other tabs and update ## Create a lifecycle workflow by using a template in the Microsoft Entra admin center --If you're using the Microsoft Entra admin center to create a workflow, you can customize existing templates to meet your organization's needs. These templates include one for common pre-hire scenarios.+Use a built-in template as the starting point for a workflow, and customize it to meet your organization's needs. For available templates and their default settings, see [Lifecycle Workflows templates](lifecycle-workflow-templates.md). To create a workflow based on a template: @@ -62,12 +66,17 @@ To create a workflow based on a template: 1. On the **Choose a workflow** page, select the workflow template that you want to use. - :::image type="content" source="media/create-lifecycle-workflow/templates-list.png" alt-text="Screenshot of a list of lifecycle workflow templates." lightbox="media/create-lifecycle-workflow/templates-list.png":::-1. On the **Basics** tab, enter a unique display name, description, and [administrative scope](manage-delegate-workflow.md) for the workflow, and then select **Next**.+ For identity-verification onboarding, select **Pre-hire identity verification initiation (Preview)** or **New Hire employee onboarding with identity verification (Preview)**. See [Lifecycle Workflows templates](lifecycle-workflow-templates.md).++ :::image type="content" source="media/create-lifecycle-workflow/templates-list.png" alt-text="Screenshot of the workflow template gallery, including the two identity-verification templates in preview." lightbox="media/create-lifecycle-workflow/templates-list.png":::++1. On the **Basics** tab, enter a unique display name, description, and [administrative scope](manage-delegate-workflow.md) for the workflow.++ 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."::: -1. On the **Configure scope** tab, select the trigger type and execution conditions to be used for this workflow. For more information on what you can configure, see [Execution conditions](understanding-lifecycle-workflows.md#execution-conditions).+1. On the **Configure scope** tab, configure the execution conditions for the workflow. For other templates, also select the trigger type on this tab. For more information on what you can configure, see [Execution conditions](understanding-lifecycle-workflows.md#execution-conditions). 1. 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](/graph/api/resources/identitygovernance-rulebasedsubjectset?view=graph-rest-beta&preserve-view=true#supported-user-properties-and-query-parameters). @@ -77,24 +86,39 @@ To create a workflow based on a template: :::image type="content" source="media/create-lifecycle-workflow/template-syntax.png" alt-text="Screenshot of workflow rule syntax."::: +1. 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":::+ 1. 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](lifecycle-workflow-tasks.md).+ 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."::: -1. On the **Review and create** tab, review the workflow's settings. You can also choose whether or not to enable the schedule for the workflow. Select **Create** to create the workflow.+1. On the **Review and create** tab, review the workflow's settings. Leave the scheduling checkbox cleared to test the workflow before automatic processing begins. Select it when you're ready to enable 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."::: > [!IMPORTANT]-> By default, a newly created workflow is disabled to allow for the testing of it first on smaller audiences. For more information about testing workflows before rolling them out to many users, see [Run an on-demand workflow](on-demand-workflow.md).+> In the Microsoft Entra admin center, a newly created workflow is enabled (`isEnabled` is `true`), but scheduling is disabled (`isSchedulingEnabled` is `false`) unless you select the scheduling checkbox. This lets you [run the workflow on-demand](on-demand-workflow.md) for a small audience before enabling scheduled processing. Disabling the workflow itself (`isEnabled` is `false`) prevents both scheduled and on-demand runs. ## Create a lifecycle workflow by using Microsoft Graph To create a lifecycle workflow by using the Microsoft Graph API, see [Create workflow](/graph/api/identitygovernance-lifecycleworkflowscontainer-post-workflows). -## Next steps+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)](/graph/api/identitygovernance-lifecycleworkflowscontainer-post-workflows?view=graph-rest-beta&preserve-view=true). For task definitions and arguments, see [Lifecycle workflow tasks](lifecycle-workflow-tasks.md).++> [!NOTE]+> Microsoft Graph beta APIs are subject to change. Use of these APIs in production applications isn't supported.++## Related content - [Manage a workflow's properties](manage-workflow-properties.md) - [Manage workflow versions](manage-workflow-tasks.md) 