Microsoft Entra ID Governance
Governance

Lifecycle Workflows tasks and definitions

In brief

The article now documents the preview task for selecting an identity-verification profile and emailing users during pre-hire onboarding, including prerequisites and Microsoft Graph beta parameters.

What Entra admins need to know

Admins need an eligible verification profile and a populated user `otherMails` address; Graph integrations must use `/beta`.

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.

}


### Select verification profile for identity verification (Preview)

This task selects an identity verification profile and sends the user an identity verification email during pre-hire onboarding. It's included in the [Pre-hire identity verification initiation (Preview)](lifecycle-workflow-templates.md#pre-hire-identity-verification-initiation-preview) template.

You can customize the task name and description in the Microsoft Entra admin center. The task shows the **Verified ID Profile** selected for the workflow. To select or change that profile, use the workflow's **Select identity verification profile** page.

:::image type="content" source="media/lifecycle-workflow-task/identity-verification-profile-task.png" alt-text="Screenshot of the pre-hire identity verification task settings, with User as the recipient and otherMails as the recipient email address property." lightbox="media/lifecycle-workflow-task/identity-verification-profile-task.png":::

The prerequisites to run the **Select verification profile for identity verification (Preview)** task are:

- An ID verification profile with purpose set to `all` or `onboarding`, selected for the workflow. For profile configuration, see [Create an ID verification profile](../verified-id/how-to-create-id-verification-profile.md).
- A populated `otherMails` attribute for the user, containing an email address the user can access.

The default email settings are **User (default)** for **To recipient** and **otherMails** for **To recipient email address property**. You can also select **CC recipients**.

This task is available only in Microsoft Graph /beta, not /v1.0. See Lifecycle Workflows overview (beta).

For Microsoft Graph, the parameters for the Select verification profile for identity verification (Preview) task are as follows:

ParameterDefinition
categoryjoiner
displayNameSelect verification profile for identity verification (Preview) (Customizable by user)
descriptionSelect an identity verification profile and send the verification email to the user (Customizable by user)
taskDefinitionId9ed82537-8442-467a-8eef-9351fb7a1f9c
argumentsverifiedIdProfileId, to, and the common email parameters cc, customSubject, customBody, and locale. See the argument descriptions below and Common email task parameters.

All argument values are strings.

ArgumentDefinition
verifiedIdProfileIdThe ID of the ID verification profile selected for the workflow.
toUser/otherMails. Sends the verification link to the user's otherMails address.
ccA user ID or comma-separated list of user IDs to copy on the email.
customSubjectA custom email subject.
customBodyA custom email message body.
localeA language value that overrides the recipient's language setting.

JSON template for a workflow task:

Replace <id-verification-profile-id> with the selected profile's ID. The example uses User/otherMails to select the user as the recipient and otherMails as the email address property, and en-us as the email language.

{
    "category": "joiner",
    "continueOnError": false,
    "description": "Select an identity verification profile and send the verification email to the user",
    "displayName": "Select verification profile for identity verification (Preview)",
    "isEnabled": true,
    "taskDefinitionId": "9ed82537-8442-467a-8eef-9351fb7a1f9c",
    "arguments": [
        {
            "name": "verifiedIdProfileId",
            "value": "<id-verification-profile-id>"
        },
        {
            "name": "to",
            "value": "User/otherMails"
        },
        {
            "name": "locale",
            "value": "en-us"
        }
    ]
}

Send manager verification status email (Preview)

This task sends the user's manager an email about the employee's verification status. It's included in both the Pre-hire identity verification initiation (Preview) and New Hire employee onboarding with identity verification (Preview) templates.

You can customize the task name and description in the Microsoft Entra admin center. The task shows the Verified ID Profile selected for the workflow. To select or change that profile, use the workflow's Select identity verification profile page.

:::image type="content" source="media/lifecycle-workflow-task/manager-verification-status-email-task.png" alt-text="Screenshot of the manager verification status email task settings, with Manager as the recipient and mail as the recipient email address property." lightbox="media/lifecycle-workflow-task/manager-verification-status-email-task.png":::

The prerequisites to run the Send manager verification status email (Preview) task are:

  • An ID verification profile with purpose set to all or onboarding, selected for the workflow.
  • For the default manager recipient, a populated manager attribute for the user and a populated mail attribute for that manager.

The default email settings are Manager (default) for To recipient and mail for To recipient email address property. You can also select CC recipients.

This task is available only in Microsoft Graph /beta, not /v1.0. See Lifecycle Workflows overview (beta).

For Microsoft Graph, the parameters for the Send manager verification status email (Preview) task are as follows:

ParameterDefinition
categoryjoiner
displayNameSend manager verification status email (Preview) (Customizable by user)
descriptionSend manager notification email about employee verification status (Customizable by user)
taskDefinitionIdc7a1f3e5-4b2d-4e8a-9f6c-3d5a7b1e2c4f
argumentsverifiedIdProfileId, to, and the common email parameters cc, customSubject, customBody, and locale. See the argument descriptions below and Common email task parameters.

All argument values are strings.

ArgumentDefinition
verifiedIdProfileIdThe ID of the ID verification profile selected for the workflow.
toUser, Manager, Sponsors, or a specific user's ID ({UserId} in the task definition). The example uses Manager, matching the admin center's default recipient.
ccA user ID or comma-separated list of user IDs to copy on the email.
customSubjectA custom email subject.
customBodyA custom email message body.
localeA language value that overrides the recipient's language setting.

JSON template for a workflow task:

Replace <id-verification-profile-id> with the selected profile's ID. The example uses Manager as the recipient and en-us as the email language.

{
    "category": "joiner",
    "continueOnError": false,
    "description": "Send manager notification email about employee verification status",
    "displayName": "Send manager verification status email (Preview)",
    "isEnabled": true,
    "taskDefinitionId": "c7a1f3e5-4b2d-4e8a-9f6c-3d5a7b1e2c4f",
    "arguments": [
        {
            "name": "verifiedIdProfileId",
            "value": "<id-verification-profile-id>"
        },
        {
            "name": "to",
            "value": "Manager"
        },
        {
            "name": "locale",
            "value": "en-us"
        }
    ]
}

Select verification for Verified ID presentation (Preview)

This task sends the user a link to present a Verified ID based on government ID verification completed through a security partner. It's included in the New Hire employee onboarding with identity verification (Preview) template.

Inline passkey registration through this task isn't supported on iOS when the applicable passkey profile has Enforce attestation enabled, or for Android work-profile passkey registration. On Android, the inline flow uses the Verified ID in Microsoft Authenticator's personal profile and registers the passkey in that profile, not the work profile. For eligible accounts, use the existing TAP task instead, with recommended Conditional Access protection for registration. See Choose a Day 1 registration path.

Inline passkey registration isn't supported for internal or external guest accounts. The current preview doesn't change this passkey guest restriction.

You can customize the task name and description in the Microsoft Entra admin center. The task shows the Verified ID Profile selected for the workflow. To select or change that profile, use the workflow's Select identity verification profile page.

:::image type="content" source="media/lifecycle-workflow-task/verified-id-presentation-task.png" alt-text="Screenshot of the Verified ID presentation task settings, with User as the recipient and otherMails as the recipient email address property." lightbox="media/lifecycle-workflow-task/verified-id-presentation-task.png":::

The prerequisites to run the Select verification for Verified ID presentation (Preview) task are:

  • An ID verification profile with purpose set to all or onboarding, selected for the workflow. For profile configuration, see Create an ID verification profile.
  • A populated otherMails attribute for the user, containing an email address the user can access.

The default email settings are User (default) for To recipient and otherMails for To recipient email address property. You can also select CC recipients.

This task is available only in Microsoft Graph /beta, not /v1.0. See Lifecycle Workflows overview (beta).

For Microsoft Graph, the parameters for the Select verification for Verified ID presentation (Preview) task are as follows:

ParameterDefinition
categoryjoiner
displayNameSelect verification for Verified ID presentation (Preview) (Customizable by user)
descriptionSend link to prompt a Verified ID presentation request based on Government ID verification done via the Security Partner (Customizable by user)
taskDefinitionId8314685b-de26-4c90-b086-bfa0e7a263f3
argumentsverifiedIdProfileId, to, and the common email parameters cc, customSubject, customBody, and locale. See the argument descriptions below and Common email task parameters.

All argument values are strings.

ArgumentDefinition
verifiedIdProfileIdThe ID of the ID verification profile selected for the workflow.
toUser/otherMails. Sends the verification link to the user's otherMails address.
ccA user ID or comma-separated list of user IDs to copy on the email.
customSubjectA custom email subject.
customBodyA custom email message body.
localeA language value that overrides the recipient's language setting.

JSON template for a workflow task:

Replace <id-verification-profile-id> with the selected profile's ID. The example uses User/otherMails to select the user as the recipient and otherMails as the email address property, and en-us as the email language.

{
    "category": "joiner",
    "continueOnError": false,
    "description": "Send link to prompt a Verified ID presentation request based on Government ID verification done via the Security Partner",
    "displayName": "Select verification for Verified ID presentation (Preview)",
    "isEnabled": true,
    "taskDefinitionId": "8314685b-de26-4c90-b086-bfa0e7a263f3",
    "arguments": [
        {
            "name": "verifiedIdProfileId",
            "value": "<id-verification-profile-id>"
        },
        {
            "name": "to",
            "value": "User/otherMails"
        },
        {
            "name": "locale",
            "value": "en-us"
        }
    ]
}

Generate Temporary Access Pass and send via email to user's manager

Microsoft Entra allows you to use a [Temporary Access Pass (TAP)](..//identity/authentication/howto-authentication-temporary-access-pass.md)Temporary Access Pass (TAP) to set up password-less credentials for users. You can also use [Microsoft Entra self-service password reset](../identity/authentication/concept-sspr-howitworks.md)Microsoft Entra self-service password reset to set a regular password. With this task, Lifecycle workflows allowWorkflows can automatically generate a TAP and email it to the selected recipient. The task catalog name refers to manager delivery, but you can also select the user as the recipient.

To send the TAP to automatically generatethe user, under Basics, set To recipient to User and To recipient email address property to otherMails. The user's otherMails attribute must contain an email address the user can access. Update Task description to reflect delivery to the user, for example, "Generate a Temporary Access Pass (TAP), and haveemail it sent to the new user's manager.user." You're also able to can customize the email that is sentunder Email Customization.

For the employee Day 1 alternative to inline passkey registration, see Configure TAP with identity-verification-protected registration. The recommended configuration uses a Conditional Access policy for Register security information with Require identity verification. This policy isn't required to use the userTAP alternative; sending a TAP alone doesn's manager. t establish identity verification.

The Microsoft Entra prerequisites to run the Generate Temporary Access Pass and send via email to user's manager task are:

  • AFor delivery to the manager, a populated manager relationship for the user and a populated mail attribute for the user.manager.
  • AFor delivery to User/otherMails with the default email body, a populatedmanager relationship for the user. The manager's mail attribute isn't required.
  • For delivery to User/otherMails with a custom email body, the default-body requirement for the user.a populated manager relationship doesn't apply.
  • The TAP tenant policy must be enabled and the selected values for activation duration and one time use must be within the allowed range of the policy. For more information, see Enable the Temporary Access Pass policy

TAP account-type restrictions apply independently of email delivery. Internal guest accounts can be issued a TAP, but external guest accounts can't be issued one in the resource tenant. See TAP guest access for the account-type and home-tenant sign-in requirements.

For eligible internal guests, use the existing TAP flow separately from the employee passkey-registration paths. Passkey (FIDO2) registration isn't supported for internal or external guests; TAP support doesn't remove this restriction, and the current preview doesn't add an exception.

For Microsoft Graph, the parameters for the Generate Temporary Access Pass and send via email to user's manager task are as follows:

|Parameter |Definition |

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…