Approvals

Enables approvals in workflows.

This connector is available in the following products and regions:

Service Class Regions
Power Automate Standard All Power Automate regions
Power Apps Standard All Power Apps regions
Contact
Name Microsoft
URL Microsoft Power Automate Support
Microsoft Power Apps Support
Connector Metadata
Publisher Microsoft

Known issues and limitations

  • Approvals timestamps will always be shown in UTC.
  • The creator of the flow will always be shown in the Approval details (email content and all clients). This is to prevent spoofing of approval sender identities.

Approval recipient format

The AssignedTo field can accept user identities in the form of:

  • Email address (not just the primary)
  • User Principal Name (UPN)
  • AAD user id (in the format XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX)

To specify multiple users, use a semi-colon (;) to separate user identifies. User types may be mixed.

Example:

jsmith@contoso.com;3b3ba145-7da5-414d-b84f-a9835eb71f3b;jane.doe@contoso.com

Approval Details

Markdown syntax is supported for custom styling in the details field of approvals. See Approvals Markdown Support for documentation

General Limits

Name Value
Connections per account 1

Throttling Limits

Name Calls Renewal Period
API calls per connection50300 seconds
Non-Get requests per connection3003600 seconds

Actions

Create an approval

Starts an automated approval process, but does not wait for the approval to complete. The approval is cancelable.

Start and wait for an approval

Starts an automated approval process and then waits for it to complete. The approval is cancelable.

Start and wait for an approval [DEPRECATED]

This action has been deprecated. Please use Start and wait for an approval instead.

Starts an automated approval process and then waits for it to complete. The approval is only canceled on timeout. (Deprecated)

Start and wait for an Approve or Reject - First to respond approval [DEPRECATED]

This action has been deprecated. Please use Start and wait for an approval instead.

Starts an automated approval process and then waits for it to complete. The approval is only canceled on timeout. (Deprecated)

Wait for an approval

Waits for a specified approval to complete.

Create an approval

Starts an automated approval process, but does not wait for the approval to complete. The approval is cancelable.

Parameters

Name Key Required Type Description
Approval type
approvalType True string

Select an approval type.

ApprovalCreationInput
ApprovalCreationInput True dynamic

The dynamic input for creating an approval of the specified type.

Returns

The outputs of this operation are dynamic.

Start and wait for an approval

Starts an automated approval process and then waits for it to complete. The approval is cancelable.

Parameters

Name Key Required Type Description
Approval type
approvalType True string

Select an approval type.

WebhookApprovalCreationInput
WebhookApprovalCreationInput True dynamic

The dynamic webhook input for creating an approval of the specified type.

Returns

The outputs of this operation are dynamic.

Start and wait for an approval [DEPRECATED]

This action has been deprecated. Please use Start and wait for an approval instead.

Starts an automated approval process and then waits for it to complete. The approval is only canceled on timeout. (Deprecated)

Parameters

Name Key Required Type Description
Approval type
approvalType True string

Select an approval type.

ApprovalCreationInput
ApprovalCreationInput True dynamic

The dynamic input for creating an approval of the specified type.

Returns

The outputs of this operation are dynamic.

Start and wait for an Approve or Reject - First to respond approval [DEPRECATED]

This action has been deprecated. Please use Start and wait for an approval instead.

Starts an automated approval process and then waits for it to complete. The approval is only canceled on timeout. (Deprecated)

Parameters

Name Key Required Type Description
Title
title True string

Specify the title of the approval.

Details
details string

Specify the details of the approval request. Markdown syntax is supported, see https://aka.ms/approvaldetails for more information.

Item Link
itemLink string

Specify a link to the item to approve.

Item Link Description
itemLinkDescription string

Specify a description for the item to approve.

Assigned To
assignedTo True email

Specify to whom the approval should be assigned. This should be a semi-colon (;) delimited collection of either email addresses, UPNs, or AAD user ids.

Returns

Wait for an approval

Waits for a specified approval to complete.

Parameters

Name Key Required Type Description
Approval ID
approvalName True string

The ID of the approval.

ApprovalSubscriptionInput
ApprovalSubscriptionInput True dynamic

The dynamic input for subscribing to an approval.

Returns

The outputs of this operation are dynamic.

Definitions

ApprovalCreationOutputV0

Name Path Type Description
Title
title string

The title of the approval.

Details
details string

The details of the approval request. Markdown syntax is supported, see https://aka.ms/approvaldetails for more information.

Item Link
itemLink string

A link to the item to approve.

Responder
responder ResponderPrincipal

The user that provided the response.

Response
response string

The approval response: Approve or Reject.

Comments
comments string

Comments provided by approver.

ResponderPrincipal

The user that provided the response.

Name Path Type Description
Approver Id
id string

The id of the approver.

Approver Name
displayName string

The name of the approver.

Approver Email
email string

The email address of the approver.

Approver Tenant Id
tenantId string

The tenant id of the approver.

Approver User Principal Name
userPrincipalName string

The principal name of the approver.