Customize Email updates

Author: OWinfreyATL

articles/active-directory/governance/customize-workflow-email.md

@@ -0,0 +1,104 @@
+---
+title: Customize emails sent out by workflow tasks
+description: A step by step guide for customizing emails sent out using tasks within Lifecycle Workflows
+author: owinfreyATL
+ms.author: owinfrey
+manager: amycolannino
+ms.service: active-directory
+ms.subservice: compliance
+ms.topic: how-to
+ms.date: 02/06/2023
+ms.custom: template-how-to
+---
+
+# Customize emails sent out by workflow tasks (Preview)
+
+Lifecycle Workflows provide many tasks related to sending emails to processed users. Email related tasks can be customized to suit the needs of  a specific workflow. For a list of these tasks, see: [Lifecycle Workflows tasks and definitions (Preview)](lifecycle-workflow-tasks.md).
+
+Emails sent out by these tasks can have the following information updated:
+
+- CC information
+- Domain of sender
+- Branding associated with email
+- Subject
+- Message body
+- Email language translation
+
+For more information on these customizable parameters, see: [Common email-specific task parameters](lifecycle-workflow-tasks.md#common-email-specific-task-parameters).
+
+## Prerequisites
+
+- Azure AD Premium P2
+
+For more information, see: [License requirements](what-are-lifecycle-workflows.md#license-requirements)
+
+To customize emails you must have the following:
+
+- A verified domain. To add a custom domain, see: [Managing custom domain names in your Azure Active Directory](../enterprise-users/domains-manage.md)
+- Custom Branding set within Azure AD if you want to have your custom branding used in emails. To set organizational branding within your Azure tenant, see: [Configure your company branding (preview)](../fundamentals/how-to-customize-branding.md).
+
+## Customize email using the Azure portal
+
+When customizing an email sent via Lifecycle workflows, you can choose to customize either a new or existing task. These customizations are done the same way no matter if the task is new or existing, but the following steps walks you through updating an existing task. To customize emails sent out from tasks within workflows using the Azure portal, you'd follow these steps:
+
+1. Sign in to the [Azure portal](https://portal.azure.com).
+
+1. Type in **Identity Governance** in the search bar near the top of the page, and select it.
+
+1. In the left menu, select **Lifecycle workflows (Preview)**. 
+
+1. In the left menu, select **workflows (Preview)**.
+    
+1. On the left side of the screen, select **Tasks (Preview)**.
+
+1. On the tasks screen, select the task for which you want to customize the email.
+
+1. On the specific task screen you are able to set CC to include others in the email outside of the default audience. 
+
+1. Select the **Email Customization** tab.
+
+1. On the email customization screen, enter a custom subject, message body, and the email language translation option that will be used to translate the message body of the email.
+    :::image type="content" source="media/customize-workflow-email/customize-workflow-email-example.png" alt-text="Example of a customized email from a workflow.":::
+1. After making changes, select **save** to capture changes to the customized email.
+
+
+## Format attributes within customized emails
+
+To further personalize customized emails, you can take advantage of dynamic attributes. With dynamic attributes by placing in specific attributes, you're able to specifically call out values such as a user's name, their generated Temporary Access Pass, or even their manager's email.
+
+To use dynamic attributes within your customized emails, you must follow the formatting rules within the customized email. The proper format is:
+
+{{**dynamic attribute**}}
+
+The following screenshot is an example of the proper format for dynamic attributes within a customized email:
+
+:::image type="content" source="media/customize-workflow-email/workflow-dynamic-attribute-example.png" alt-text="Example of dynamic attributes in customized emails.":::
+
+When typing this it will be written the following way:
+
+```html
+Welcome to the team, {{userGivenName}}
+
+We're excited to have you join our growing team and look forward to a successful and memorable journey together.
+
+We've already set up a few things to help you get started quickly and make your onboarding process as smooth as possible.
+
+For more information and next steps, please contact your manager, {{managerDisplayName}} 
+
+```
+
+For a full list of dynamic attributes that can be used with customized emails, see:[Dynamic attributes within email](lifecycle-workflow-tasks.md#dynamic-attributes-within-email).
+
+
+
+
+## Customize email using Microsoft Graph
+
+To customize email using Microsoft Graph API see: [workflow: createNewVersion](/graph/api/identitygovernance-workflow-createnewversion).
+
+## Next steps
+
+- [Lifecycle Workflow tasks](lifecycle-workflow-tasks.md)
+- [Manage workflow versions](manage-workflow-tasks.md)
+
+