Share via

Human in the loop

Enables human input in workflows and agents.

This connector is available in the following products and regions:

Service Class Regions
Copilot Studio Standard All Power Automate regions
Contact
Name Microsoft
URL https://support.microsoft.com
Connector Metadata
Publisher Microsoft
Website https://microsoft.com
Privacy policy https://www.microsoft.com/privacy/privacystatement
Categories AI

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 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.

Tip

For more information on how to use these connector actions, visit:

General Limits

Name Value
Connections per account 1

Throttling Limits

Name Calls Renewal Period
Approval Create requests per flow 50 60 seconds
Approval Non-Create requests per flow 500 60 seconds

Actions

Request for information (preview)

Sends a request with specified inputs to assigned humans. When the assignee responds, the responses can be used in the remaining workflow steps.
Run a multistage approval (preview)

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

Request for information (preview)

Operation ID:
RequestForInformation

Sends a request with specified inputs to assigned humans. When the assignee responds, the responses can be used in the remaining workflow steps.

Parameters

Name Key Required Type Description
Title
 title True string

Specify the title of the request.
Message (Outlook only)
 message True string

Specify the message for the request.
Assigned to (first to respond)
 assignedTo True email

Recipient email addresses, UPNs, or Microsoft Entra user ids separated by semicolons. The response from the first user to respond to the request is used.

Returns

response
object

Run a multistage approval (preview)

Operation ID:
StartAndWaitForAnApprovalProcess

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

Parameters

Name Key Required Type Description
Approval Process
 approvalProcessId True string

Select an approval process.
WebhookApprovalProcessCreationInput
 WebhookApprovalProcessCreationInput True dynamic

Fetch the input fields dynamically from Flow-RP. They include inputs like Title as well as the input fields the user defined in their approval process.

Returns

The outputs of this operation are dynamic.

Definitions

object

This is the type 'object'.