Assign task to users action

The Assign task to users action creates and assigns a workflow task to a user or group. It pauses the recipe job until the task reaches completion or expires. This action enables workflows that require user intervention, such as reviews, approvals, and rejections. Workato creates the task using the configured Task name, Assignee, and Record ID.

When the recipe reaches this step, Workato creates the task and sends an email notification to the assignee(s) if the Send email notification to assignee parameter is enabled. App-users can access the task through the email link, the Workflow apps portal homepage, or the Go to task option on the application page. Assignees can complete the task in the portal or use the Complete workflow task programmatically action. Tasks not completed within the specified timeframe expire, and the recipe resumes with the task marked as Expired.

Input

Input field	Description
Workflow app	Choose the workflow app where Workato assigns the task.
Record ID	Specify the request to create the user task for. Use a datapill or enter the exact ID.
Workflow stage	Choose the workflow stage to switch to while the task is active. Select one of the stages defined in your application settings or leave this field blank to keep the current stage.
Task name	Provide a description for the task. This name appears in email subject lines and helps users identify the task. Use datapills to personalize it.
Assignee	Assign the task to a user or user group. Assignees can access the task and receive an email if the Send email notification to assignee parameter is enabled.
Page	Select an existing page or create a new one for users to complete the task in.
Number of days to complete task	Specify the timeframe for task completion by either selecting from the list or entering a custom value. The maximum allowed value is 365 days. Tasks expire automatically if not completed within this timeframe.
Send email notification to assignee	Choose whether to notify the assignee through email. This field defaults to Yes.
Allow assignee to reassign task	Choose whether assignees can reassign the task. Managers can still reassign tasks even if this option is disabled.

Output

The output from the Assign task to users action includes two main objects. The Task object provides consistent details about the task created by the action, such as its ID, name, status, custom status label, and timestamps. The Record object dynamically reflects data from the Workflow app’s corresponding data table. Attributes in the Record object vary depending on the Workflow app configuration and its data table.

Output field	Description
Task	The task object contains details about the task created by the action, such as its Task ID, Task name, Status, and Custom status label.
Record	The record object contains details about the request associated with the task, such as its Record ID, User name, and Department.