You are here:
Request an Approval Action
Run an active, autolaunched flow approval process with the specified inputs asynchronously. This action doesn’t submit a record for approvals that use Classic Approval Processes.
Required Editions
| View supported editions for Flow Orchestration. |
Special Access Rules
- This action requires that you turn on Flow Approval Processes.
In Flow Builder, add an Action element to your flow. In the Action properties panel, select the Flow Approval Processes folder, and then select the name of the active, autolaunched flow approval process to run from the flow.
Set Timeout Length
Actions that run asynchronously in flows have 2 paths: Completed and Timed Out.
| Field | Description |
|---|---|
| Amount of Time | Optional. The maximum amount of time to pause the flow while waiting for the flow approval process to complete. The default timeout length is 1 day. |
Set Input Values for the Selected Flow Approval Process
Each flow approval process has at least 3 inputs that all autolaunched flow approval processes contain. A flow approval process can also contain other inputs.
Use values from earlier in the flow to set the inputs for the action.
| Field | Description |
|---|---|
| Record ID | Required. The ID of the record to submit for approval. Open approval work items for this record appear in the Orchestration Work Guide component after you add the component to the record page layout. |
| Submitter ID | Required. The ID of the user submitting the approval. |
| Submission Comments | Comments about the approval. |
Store Output Values
Each flow approval process contains at least 2 outputs. A flow approval process can also contain other outputs, depending on its version definition.
| Output Parameter | Description |
|---|---|
| Correlation ID | The ID that correlates to the asynchronous response. For internal use only. |
| Orchestration Run ID | The ID of the orchestration run that this action creates. The orchestration run is a run-time instance of the specified approval process. |
Usage
This action is available in flow running API version 64.0 and later.
Set a timeout that gives the flow approval process enough time to complete as expected before timing out.
Inputs specific to the selected flow approval process appear after the required input values. The Process Simple Approval flow approval process has 2 more inputs. When a selected flow approval process uses these inputs, they appear by label. The action lists all other process-specific inputs by the input variable's API name.
| Input Variable | Input Label | Description |
|---|---|---|
firstApprover |
Selected Approver | The designated user, group, or queue to act as the reviewer for one or more approval steps. Valid values are:
|
submissionInfo |
Submission Information | Information about the record to submit for approval. |
If an active, autolaunched flow approval processes assigns one or more approval steps to a Resource assignee type, it requires at least one input variable. The input variable must contain the username of an active user, the API name of a public group, or the API name of a queue.
