--- title: "Configure Orchestrate Email Task in Construct" slug: "configure-orchestrate-email-task-in-construct" updated: 2025-01-28T09:55:32Z published: 2025-01-28T09:55:32Z canonical: "skthelp.syniti.com/configure-orchestrate-email-task-in-construct" --- > ## Documentation Index > Fetch the complete documentation index at: https://skthelp.syniti.com/llms.txt > Use this file to discover all available pages before exploring further. # Configure Orchestrate Email Task in Construct ## Overview Complete the following steps to configure an Email task using an Orchestrate Workflow: 1. [Create a Custom Email Template](/docs/configure-orchestrate-email-task-in-construct#create-a-custom-email-template) 2. [Create an Orchestrate Workflow](/docs/configure-orchestrate-email-task-in-construct#create-an-orchestrate-workflow) 3. [Create an Event and Orchestrate Workflow Business Rule](/docs/configure-orchestrate-email-task-in-construct#create-an-event-and-orchestrate-workflow-business-rule) ### Create a Custom Email Template 1. In the Syniti Knowledge Platform (SKP), access **Admin > Email Templates**. Refer to [Email Templates](/v1/docs/email-templates) for more information. 2. Create a new email template of **Custom** type where you can define the variables to subsitute values in both Subject and Body fields that you want to populate from Construct. > [!NOTE] > Note > > Use the variable naming format **{{.VariableName}}** to introduce all the variables you need in the custom email template. ![](https://cdn.document360.io/ca09b4e9-1857-4c63-9f0e-1f25f166f447/Images/Documentation/image(618).png?sv=2026-02-06&spr=https&st=2026-11-17T19%3A21%3A43Z&se=2026-11-17T20%3A21%3A43Z&sr=b&sp=r&sig=KqiEuPhQSAh2iqt7mrbq4X7HBCUfhRCP43%2BuwoUBv9g%3D) 3. Click **Save**. ### Create an Orchestrate Workflow 1. In the SKP, access **Orchestrate > Workflows** and create a new workflow. 2. In the Tasks section, click **Add Task** and select **Email** from the Task Type list. 3. From the Select Template list, select the template you have created from Step 2 and enter a Name and Description for that task. ![A screenshot of a computer Description automatically generated](https://cdn.document360.io/ca09b4e9-1857-4c63-9f0e-1f25f166f447/Images/Documentation/image-1731912858283.png?sv=2026-02-06&spr=https&st=2026-11-17T19%3A21%3A43Z&se=2026-11-17T20%3A21%3A43Z&sr=b&sp=r&sig=P%2BmyM4Uep7faEsm8T5S1mRTSpAnbyWgS3imikK1FTi8%3D) 4. Click **Save**. All the variables configured in the template will be automatically added to the Variables section. 5. Add **boaUserEmail** as a variable and any key fields for the table or page where you are going to use this Orchestrate workflow. This variable is mandatory. > [!NOTE] > Note > > The value for boaUserEmail will be the email address of the user who triggers the event on the Construct page. ![](https://cdn.document360.io/ca09b4e9-1857-4c63-9f0e-1f25f166f447/Images/Documentation/image(653).png?sv=2026-02-06&spr=https&st=2026-11-17T19%3A21%3A43Z&se=2026-11-17T20%3A21%3A43Z&sr=b&sp=r&sig=yrRyaygLb%2Bov63tvvR6PxZSBrgzNaVp4JYkK1ysaMKk%3D) 6. The TO, CC, and BCC variables or email address fields will be automatically added to the workflow. For any of these email address fields, you can use the user’s principal ID, a user group ID, or an email address. > [!NOTE] > Note > > The email address must be a valid email address registered in the SKP for your tenant. Multiple recipients can be entered in a comma separated list. 1. To copy the user’s principal ID, click **Profile > Your Name** in the SKP. ![](https://cdn.document360.io/ca09b4e9-1857-4c63-9f0e-1f25f166f447/Images/Documentation/image(655).png?sv=2026-02-06&spr=https&st=2026-11-17T19%3A21%3A43Z&se=2026-11-17T20%3A21%3A43Z&sr=b&sp=r&sig=dz6F6jnFi%2BC1yAP47I0yV%2BsRau1UsM4nRKpbAyYq95Y%3D) 2. To copy a user group ID, access **Admin > User Group**, select the intended user group, and then copy the user group ID from your browser’s URL.![](https://cdn.document360.io/ca09b4e9-1857-4c63-9f0e-1f25f166f447/Images/Documentation/image(654).png?sv=2026-02-06&spr=https&st=2026-11-17T19%3A21%3A43Z&se=2026-11-17T20%3A21%3A43Z&sr=b&sp=r&sig=RMSC%2BKubQfcUk76DiAvL6hozT8w0jv%2BIDzJOm3rNVIs%3D) 7. If you need to capture when the email was sent and by whom, you can add a WorkflowedOn column of datetime data type and a WorkflowedBy column of nvarchar(100) data type to the table using an SQL Task after the Email task in the same workflow using the following SQL code: ```plaintext UPDATE SET  WorkflowedOn = GETDATE(),  WorkflowedBy = :boaUserEmail WHERE  YourPK =  :YourPK ``` ![A screenshot of a computer Description automatically generated](https://cdn.document360.io/ca09b4e9-1857-4c63-9f0e-1f25f166f447/Images/Documentation/configure-orchestrate-email-task-in-construct-image-sbzd8h4w.png?sv=2026-02-06&spr=https&st=2026-11-17T19%3A21%3A43Z&se=2026-11-17T20%3A21%3A43Z&sr=b&sp=r&sig=RrSrbBUE3Q9LWzrvtZ80XgAU5ErR%2Bt%2BKxgsLm7Hiv%2B4%3D) > [!NOTE] > Note > > Any of the variables can be manually managed in the Workflow variables for the configured values used every time. To pass any variable to the workflow from the Construct Page record, you need a field in the Construct Page view with the same name as the variable. > > For example, if you have a field named To on the Construct Page, the value for that field will be used using the To variable in the Email Task and Orchestrate Workflow. ### Create an Event and Orchestrate Workflow Business Rule 1. Add an Orchestrate Workflow for the Construct Page’s Event where you need to execute it in Construct. Refer to [Create an Orchestrate Workflow Business Rule](/v1/docs/business-rules#create-an-orchestrate-workflow-business-rule) for more information. ![A screenshot of a computer Description automatically generated](https://cdn.document360.io/ca09b4e9-1857-4c63-9f0e-1f25f166f447/Images/Documentation/configure-orchestrate-email-task-in-construct-image-3mtmhw3u.png?sv=2026-02-06&spr=https&st=2026-11-17T19%3A21%3A43Z&se=2026-11-17T20%3A21%3A43Z&sr=b&sp=r&sig=3w%2Bmuhs5RXo1d5ZgK6%2FB5yNu4FTvFPO%2F5N8S11ng4hc%3D) 2. Execute the Event from the Construct Page. Construct triggers the Orchestrate Workflow and the email will be sent immediately. For example, ![A screenshot of a computer Description automatically generated](https://cdn.document360.io/ca09b4e9-1857-4c63-9f0e-1f25f166f447/Images/Documentation/image-1731913317210.png?sv=2026-02-06&spr=https&st=2026-11-17T19%3A21%3A43Z&se=2026-11-17T20%3A21%3A43Z&sr=b&sp=r&sig=%2BRiSzh4JjdZx%2BRWu1v%2BGRyQldIYqFwaeiwKrm%2B%2Fw9ek%3D)Where the body was retrieved from the Construct Page. The WorkflowedOn and WorkflowedBy fields are updated accordingly. ![A screenshot of a computer Description automatically generated](https://cdn.document360.io/ca09b4e9-1857-4c63-9f0e-1f25f166f447/Images/Documentation/configure-orchestrate-email-task-in-construct-image-045aypr6.png?sv=2026-02-06&spr=https&st=2026-11-17T19%3A21%3A43Z&se=2026-11-17T20%3A21%3A43Z&sr=b&sp=r&sig=ej6l0mqJpWOARkT5Ei0tZWEffd9mViW6AT2i8jm%2BSIg%3D) ## Related Articles - [Create an Orchestrate Workflow Business Rule](/v1/docs/business-rules#create-an-orchestrate-workflow-business-rule) - [Email Templates](/v1/docs/email-templates) - [Tasks](/v1/docs/tasks) - [Workflows](/v1/docs/workflows)