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.
- 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:
[email protected];3b3ba145-7da5-414d-b84f-a9835eb71f3b;[email protected]
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.
|
| 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.
|
| 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
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
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
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.
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 addresses, separated by a semicolon (;) |
|
|
Requestor
|
requestor |
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
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 |
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
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
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
|
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 |