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 connection | 50 | 300 seconds |
| Non-Get requests per connection | 300 | 3600 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 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 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 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
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. |