Limited Release
This action is in limited release and is not generally available.
Wait for Approval
The Wait for Approval action pauses a workflow and sends an approval request email to a designated recipient. The workflow remains paused until the recipient approves or rejects the request, or until the configured expiration window elapses.
When to Use This Action
Use this action when:
- A workflow needs human approval before proceeding with sensitive or irreversible actions (e.g., deleting records, sending bulk communications, modifying configuration)
- An external stakeholder needs to review and sign off on an automated request before it continues
- You want to build a change management or expense approval step into a workflow
Configuration
| Field | Description |
|---|---|
| Email Address | The recipient who will receive the approval request email. Supports text expressions. |
| Subject | Subject line for the approval email. Supports text expressions. |
| Message | Approval request message body explaining what is being requested. Supports text expressions. |
| Expires In (Hours) | How long the approval request remains active before expiring. Minimum 1 hour, maximum 168 hours (7 days), default 24 hours. |
| Allow Approver to Add Comments | When enabled, the approver can include comments with their approval or rejection response. |
| Action if Rejected | Controls what happens to the workflow if the request is rejected. |
| Action if Expired | Controls what happens to the workflow if the request expires before a response is submitted. |
Returned Variables
If you set Store the results in Variable, the action returns an object with the following properties:
| Variable | Type | Description |
|---|---|---|
IsApproved | bool | true when the request was approved. |
IsRejected | bool | true when the request was rejected. |
IsExpired | bool | true when the request expired before a response was received. |
Status | approved|rejected|expired | The final disposition of the approval request. |
Comments | string | Comments provided by the approver. Empty string when no comments were given. |
RespondedAt | string|null | ISO-8601 timestamp of when the response was submitted. null if the request expired without a response. |
Behavior
- Sends an approval email to the configured recipient. The email contains a secure link for the approver to respond.
- Pauses the workflow until the approver responds or the configured expiration window elapses.
- When the approver approves or rejects via the link, the workflow resumes immediately.
- If approved, the workflow continues and the action returns the result object.
- If rejected, the workflow applies the configured Action if Rejected behavior.
- If no response arrives before the expiration window, the request is marked as expired, the workflow applies the configured Action if Expired behavior, and
IsExpiredis set totrue.
Notes
- Only one approval email is sent per workflow step. Re-running or retrying the step does not send duplicate emails.
- The approval link is unique to the request and can only be used once. After responding, the link cannot be used again.
- You can use the returned
Statusor boolean variables in subsequent If conditions to branch the workflow based on the outcome.
Availability
This action is currently limited release.