Share via

Approvals

  • Reference

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.
  • Actionable Approval mails in Outlook are not supported for Guest users in a tenant. Guest users will need to go to the Power Automate portal in order to act on an approval.
  • Approvals that rely on custom responses can fail if sent to many users with the type set to "Everyone must approve", due to data size limitations of the results field.
  • Approvals with multiple attachments of the same name cannot be created. Attachment names need to be unique in order for Approval notifications to be sent.
  • Approval emails are always sent from a standard email account. For security purposes approval emails are actionable only when sent from this standard email account. Users can choose to send their own email notification with a link to the approval, but those emails will not be actionable, i.e. you cannot approve/reject the approval from within the email.
  • Valid responses to a Basic or Await all approval type are "Approve" and "Reject". These responses are case-sensitive.

Approval recipient format

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

  • Email address (not just the primary)
  • User Principal Name (UPN)
  • Microsoft Entra ID 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
Approval Create requests per flow 150 60 seconds
Approval Non-Create requests per flow 500 60 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 approval of text

Starts an automated text approval process and then waits for it to complete. The approval is cancelable.
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

Operation ID:
CreateAnApproval

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

Operation ID:
StartAndWaitForAnApproval

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]

Operation ID:
approvalSubscribeV2

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 approval of text

Operation ID:
StartAndWaitForATextSuggestionApproval

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

Parameters

Name Key Required Type Description
Title
 title True string

Create a title of the approval
Suggested text
 suggestedText True string

Specify suggested text to approve or modify
Details
 details string

Markdown syntax is supported (see https://aka.ms/approvaldetails)
Item Link
 itemLink string

Add a link to the item to approve.
Item Link Description
 itemLinkDescription string

Describe the link to the item
Assigned To
 assignedTo True email

Email addresses, separated by a semicolon (;)
Requestor
 requestor email

Add the email of the person generating this request
Enable notifications
 enableNotifications boolean

Enable email, push, and Teams notifications
Enable reassignment
 enableReassignment boolean

Enable reassignment of approval requests
Name
 name string

Attachment name
Content
 content string

Attachment content

Returns

Body
TextSuggestionApprovalCreationOutput

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

Operation ID:
approvalSubscribe

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 Microsoft Entra ID user ids.

Returns

Body
ApprovalCreationOutputV0

Wait for an approval

Operation ID:
WaitForAnApproval

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.

TextSuggestionApprovalCreationOutput

Name Path Type Description
Accepted text
 acceptedText string

The accepted text of the approval
Approval ID
 name string

The name of the approval
Title
 title string

The title of the approval
Details
 details string

Additional details about the request
Item Link
 itemLink string

A link to the item to approve
Item link description
 itemLinkDescription string

Describe the link to the item
Request date
 requestDate date

Date the approval request was sent
Response summary
 responseSummary string

A summary of the responses
Completion date
 completionDate date

Date the approval was completed
Outcome
 outcome string

The outcome of the approval
Responses
 responses array of object

All of the responses
Approver ID
 responses.responder.id string

The ID of the approver
Approver name
 responses.responder.displayName string

The name of the approver
Approver email
 responses.responder.email string

The email address of the approver
Approver tenant ID
 responses.responder.tenantId string

The tenant id of the approver
Approver user principal name
 responses.responder.userPrincipalName string

The principal name of the approver
Request date
 responses.requestDate date

Date the approval request was sent
Response date
 responses.responseDate date

Date the approval response was sent
Approver response
 responses.approverResponse string

The response from the approver
Comments
 responses.comments string

Comments provided by approver