Skip to main content
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

FieldDescription
Email AddressThe recipient who will receive the approval request email. Supports text expressions.
SubjectSubject line for the approval email. Supports text expressions.
MessageApproval 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 CommentsWhen enabled, the approver can include comments with their approval or rejection response.
Action if RejectedControls what happens to the workflow if the request is rejected.
Action if ExpiredControls 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:

VariableTypeDescription
IsApprovedbooltrue when the request was approved.
IsRejectedbooltrue when the request was rejected.
IsExpiredbooltrue when the request expired before a response was received.
Statusapproved|rejected|expiredThe final disposition of the approval request.
CommentsstringComments provided by the approver. Empty string when no comments were given.
RespondedAtstring|nullISO-8601 timestamp of when the response was submitted. null if the request expired without a response.

Behavior

  1. Sends an approval email to the configured recipient. The email contains a secure link for the approver to respond.
  2. Pauses the workflow until the approver responds or the configured expiration window elapses.
  3. When the approver approves or rejects via the link, the workflow resumes immediately.
  4. If approved, the workflow continues and the action returns the result object.
  5. If rejected, the workflow applies the configured Action if Rejected behavior.
  6. If no response arrives before the expiration window, the request is marked as expired, the workflow applies the configured Action if Expired behavior, and IsExpired is set to true.

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 Status or boolean variables in subsequent If conditions to branch the workflow based on the outcome.

Availability

This action is currently limited release.