Power Automate Management

Power Automate Management connector enables interaction with Power Automate Management service. For example: creating, editing, and updating flows. Administrators who want to perform operations with admin privileges should call actions with the 'as Admin' suffix.

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
Website	https://flow.microsoft.com/

General Limits

Name	Value
Connections per account	50

Creating a connection

The connector supports the following authentication types:

First Party	Use First Party Authentication.	All regions	Not shareable
Default [DEPRECATED]	This option is only for older connections without an explicit authentication type, and is only provided for backward compatibility.	All regions	Not shareable

First Party

Auth ID: firstParty

Applicable: All regions

Use First Party Authentication.

This is not shareable connection. If the power app is shared with another user, another user will be prompted to create new connection explicitly.

Default [DEPRECATED]

Applicable: All regions

This option is only for older connections without an explicit authentication type, and is only provided for backward compatibility.

This is not shareable connection. If the power app is shared with another user, another user will be prompted to create new connection explicitly.

Throttling Limits

Name	Calls	Renewal Period
API calls per connection	5	60 seconds
Non-Get requests per connection	300	3600 seconds

Actions

Cancel Flow Run	Cancel a flow run.
Create Connection	Create a connection for the given connector in an environment.
Create Flow	Create flow
Delete Flow	Delete the given flow in an environment
Get Connector	Get the given connector in an environment.
Get Flow	Get the given flow in an environment.
Get Flow as Admin	Get the given flow from an environment you have admin access to.
List Callback URL	List callback URL for the given flow in an environment.
List Connectors	Lists all of the connectors available in the given environment. This list will include custom connectors as well as the built-in connectors.
List Flow Owners	List all owners of the given flow in an environment.
List Flow Run-Only Users	List all run only users of the given flow in an environment.
List Flows as Admin (deprecated) [DEPRECATED]	This action has been deprecated. Please use List Flows as Admin (V2) instead. List all flows in the given environment you have admin access to (deprecated).
List Flows as Admin (V2)	List all flows in the given environment you have admin access to. This V2 action is a higher performance action that returns only the identifying information about the flow. The flow definition and much of the metadata is not returned. For additional metadata and the flow definition, make a subsequent call to the Get Flows as Admin action.
List My Connections	Lists all your connection available in the given environment.
List My Environments	List the environments you have access to.
List My Flows	List all flows you created in the given environment.
Modify Flow Owners	Modify owners of the given flow in an environment.
Modify Flow Owners as Admin	Modify owners of the given flow created in an environment you have admin access to.
Modify Run-Only Users	Modify run-only users of the given flow in an environment.
Restore Deleted Flow as Admin	Restore the given soft-deleted flow in an environment you have admin access to.
Resubmit Flow	Resubmit the given flow run in an environment.
Turn Off Flow	Stop the given flow in an environment.
Turn On Flow	Start the given flow in an environment.
Update Flow	Update the given flow in an environment.

Cancel Flow Run

Operation ID:

CancelFlowRun

Cancel a flow run.

Parameters

Name	Key	Required	Type	Description
Environment	environmentName	True	string	Select environment
Flow	flowName	True	string	Select flow
Run ID	runId	True	string	The ID of the flow run to resubmit.

Create Connection

Operation ID:

CreateConnection

Create a connection for the given connector in an environment.

Parameters

Name	Key	Required	Type	Description
Environment	environmentName	True	string	Select environment
Connector	apiName	True	string	Select connector
connection	connection		dynamic	Connection

Returns

The outputs of this operation are dynamic.

Create Flow

Operation ID:

CreateFlow

Create flow

Parameters

Name	Key	Required	Type	Description
Environment	environmentName	True	string	Select environment
Flow Name	name		string
Flow Display Name	displayName	True	string
Flow State	state	True	string
Connection Name	connectionName		string
Connection Display Name	displayName		string
Connector Id	id	True	string
Either Embedded or Invoker connection	source		string
Logical name of the connection reference	connectionReferenceLogicalName		string
Connector Name	name		string
Connector Display Name	displayName		string
Connection Created Time	createdTime		date-time
Connector Runtime Url	primaryRuntimeUrl		string
Connector Icon Url	iconUri		string
Connector is Custom Api	isCustomApi		boolean
Connector Tier	tier		string
Flow Created Time	createdTime		date-time
Flow Modified Time	lastModifiedTime		date-time
Flow Template Name	templateName		string
Flow Trigger Uri	flowTriggerUri		string
Flow Installation Status	installationStatus		string
Creator tenant ID	tenantId	True	string
Creator object ID	objectId		string
Creator user ID	userId	True	string
Creator user type	userType	True	string
Flow trigger type	type		string
Flow trigger kind	kind		string
Action type	type		string
Swagger operation Id	swaggerOperationId		string
Action Api name	name		string
Action Api id	id		string
Action Api type	type		string

Returns

Body

Flow

Delete Flow

Operation ID:

DeleteFlow

Delete the given flow in an environment

Parameters

Name	Key	Required	Type	Description
Environment	environmentName	True	string	Select environment
Flow	flowName	True	string	Select flow

Get Connector

Operation ID:

GetApi

Get the given connector in an environment.

Parameters

Name	Key	Required	Type	Description
Environment	environmentName	True	string	Select environment
Connector	apiName	True	string	Select connector

Returns

The outputs of this operation are dynamic.

Get Flow

Operation ID:

GetFlow

Get the given flow in an environment.

Parameters

Name	Key	Required	Type	Description
Environment	environmentName	True	string	Select environment
Flow	flowName	True	string	Select flow

Returns

Body

FlowWithConnectionReferences

Get Flow as Admin

Operation ID:

AdminGetFlow

Get the given flow from an environment you have admin access to.

Parameters

Name	Key	Required	Type	Description
Environment	environmentName	True	string	Select environment
Flow	flowName	True	string	Select flow
Include Flow Definition	includeFlowDefinition		boolean	Whether or not to include flow definition.

Returns

Body

AdminFlowWithConnectionReferences

List Callback URL

Operation ID:

ListCallbackUrl

List callback URL for the given flow in an environment.

Parameters

Name	Key	Required	Type	Description
Environment	environmentName	True	string	Select environment
Flow	flowName	True	string	Select flow

Returns

Body

FlowListCallbackUrlResponse

List Connectors

Operation ID:

ListApis

Lists all of the connectors available in the given environment. This list will include custom connectors as well as the built-in connectors.

Parameters

Name	Key	Required	Type	Description
Environment	environmentName	True	string	Select environment

Returns

Body

ResourceArray[ApiWithoutConnectionParameters]

List Flow Owners

Operation ID:

ListFlowOwners

List all owners of the given flow in an environment.

Parameters

Name	Key	Required	Type	Description
Environment	environmentName	True	string	Select environment
Flow	flowName	True	string	Select flow

Returns

Body

ResourceArray[FlowPermission]

List Flow Run-Only Users

Operation ID:

ListFlowUsers

List all run only users of the given flow in an environment.

Parameters

Name	Key	Required	Type	Description
Environment	environmentName	True	string	Select environment
Flow	flowName	True	string	Select flow

Returns

Body

ResourceArray[FlowPermission]

List Flows as Admin (deprecated) [DEPRECATED]

Operation ID:

ListFlowsInEnvironment

This action has been deprecated. Please use List Flows as Admin (V2) instead.

List all flows in the given environment you have admin access to (deprecated).

Parameters

Name	Key	Required	Type	Description
Environment	environmentName	True	string	Select environment
Top count	$top		integer	Top count
Expand Suspension Info	expandSuspensionInfo		boolean	Expands the suspension information
Include Soft-Deleted Flows	includeSoftDeletedFlows		boolean	Whether or not to include soft-deleted flows.

Returns

Body

ResourceArray[AdminFlow]

List Flows as Admin (V2)

Operation ID:

ListFlowsInEnvironment_V2

List all flows in the given environment you have admin access to. This V2 action is a higher performance action that returns only the identifying information about the flow. The flow definition and much of the metadata is not returned. For additional metadata and the flow definition, make a subsequent call to the Get Flows as Admin action.

Parameters

Name	Key	Required	Type	Description
Environment	environmentName	True	string	Select environment
Top count	$top		integer	Top count
Expand Suspension Info	expandSuspensionInfo		boolean	Expands the suspension information
Include Soft-Deleted Flows	includeSoftDeletedFlows		boolean	Whether or not to include soft-deleted flows.

Returns

Body

ResourceArray[AdminFlowWithoutDefinition]

List My Connections

Operation ID:

ListConnections

Lists all your connection available in the given environment.

Parameters

Name	Key	Required	Type	Description
Environment	environmentName	True	string	Select environment

Returns

Body

ResourceArray[ConnectionWithoutConnectionParameters]

List My Environments

Operation ID:

ListUserEnvironments

List the environments you have access to.

Returns

Body

ResourceArray[Environment]

List My Flows

Operation ID:

ListMyFlows

List all flows you created in the given environment.

Parameters

Name	Key	Required	Type	Description
Environment	environmentName	True	string	Select environment

Returns

Body

ResourceArray[AdminFlow]

Modify Flow Owners

Operation ID:

ModifyFlowOwners

Modify owners of the given flow in an environment.

Parameters

Name	Key	Required	Type	Description
Environment	environmentName	True	string	Select environment
Flow	flowName	True	string	Select flow
Add User Object Id	id	True	string
Add User Type	type	True	string
Remove User Object Id	id	True	string
Remove User Type	type	True	string

Modify Flow Owners as Admin

Operation ID:

AdminModifyFlowOwners

Modify owners of the given flow created in an environment you have admin access to.

Parameters

Name	Key	Required	Type	Description
Environment	environmentName	True	string	Select environment
Flow	flowName	True	string	Select flow
Add User Object Id	id	True	string
Add User Type	type	True	string
Remove User Object Id	id	True	string
Remove User Type	type	True	string

Modify Run-Only Users

Operation ID:

ModifyRunOnlyUsers

Modify run-only users of the given flow in an environment.

Parameters

Name	Key	Required	Type	Description
Environment	environmentName	True	string	Select environment
Flow	flowName	True	string	Select flow
Add User Object Id	id	True	string
Add User Type	type	True	string
Remove User Object Id	id	True	string
Remove User Type	type	True	string

Restore Deleted Flow as Admin

Operation ID:

AdminRestoreFlow

Restore the given soft-deleted flow in an environment you have admin access to.

Parameters

Name	Key	Required	Type	Description
Environment	environmentName	True	string	Select environment
Flow	flowName	True	string	Select flow

Returns

Body

AdminFlowWithConnectionReferences

Resubmit Flow

Operation ID:

ResubmitFlow

Resubmit the given flow run in an environment.

Parameters

Name	Key	Required	Type	Description
Environment	environmentName	True	string	Select environment
Flow	flowName	True	string	Select flow
Trigger Name	triggerName	True	string	Name of the flow trigger to resubmit.
Run ID	runId	True	string	The ID of the flow run to resubmit.

Turn Off Flow

Operation ID:

StopFlow

Stop the given flow in an environment.

Parameters

Name	Key	Required	Type	Description
Environment	environmentName	True	string	Select environment
Flow	flowName	True	string	Select flow

Turn On Flow

Operation ID:

StartFlow

Start the given flow in an environment.

Parameters

Name	Key	Required	Type	Description
Environment	environmentName	True	string	Select environment
Flow	flowName	True	string	Select flow

Update Flow

Operation ID:

UpdateFlow

Update the given flow in an environment.

Parameters

Name	Key	Required	Type	Description
Environment	environmentName	True	string	Select environment
Flow	flowName	True	string	Select flow
Flow Name	name		string
Flow Display Name	displayName	True	string
Flow State	state	True	string
Connection Name	connectionName		string
Connection Display Name	displayName		string
Connector Id	id	True	string
Either Embedded or Invoker connection	source		string
Logical name of the connection reference	connectionReferenceLogicalName		string
Connector Name	name		string
Connector Display Name	displayName		string
Connection Created Time	createdTime		date-time
Connector Runtime Url	primaryRuntimeUrl		string
Connector Icon Url	iconUri		string
Connector is Custom Api	isCustomApi		boolean
Connector Tier	tier		string
Flow Created Time	createdTime		date-time
Flow Modified Time	lastModifiedTime		date-time
Flow Template Name	templateName		string
Flow Trigger Uri	flowTriggerUri		string
Flow Installation Status	installationStatus		string
Creator tenant ID	tenantId	True	string
Creator object ID	objectId		string
Creator user ID	userId	True	string
Creator user type	userType	True	string
Flow trigger type	type		string
Flow trigger kind	kind		string
Action type	type		string
Swagger operation Id	swaggerOperationId		string
Action Api name	name		string
Action Api id	id		string
Action Api type	type		string

Returns

Body

Flow

Definitions

ResourceArray[ApiWithoutConnectionParameters]

Name	Path	Type	Description
value	value	array of ApiWithoutConnectionParameters

ResourceArray[ConnectionWithoutConnectionParameters]

Name	Path	Type	Description
value	value	array of ConnectionWithoutConnectionParameters

ResourceArray[Environment]

Name	Path	Type	Description
value	value	array of Environment

ResourceArray[AdminFlow]

Name	Path	Type	Description
value	value	array of AdminFlow

ResourceArray[AdminFlowWithoutDefinition]

Name	Path	Type	Description
value	value	array of AdminFlowWithoutDefinition

ResourceArray[FlowPermission]

Name	Path	Type	Description
value	value	array of FlowPermission

FlowPermission

Name	Path	Type	Description
Permission Name	name	string
properties	properties	PermissionProperties

PermissionProperties

Name	Path	Type	Description
roleName	roleName	string
principal	principal	Principal

Principal

Name	Path	Type	Description
Object Id	id	string
Display Name	displayName	string
Email	email	string
Type	type	string
Tenant Id	tenantId	string
Principal Name	userPrincipalName	string
Owner Thumbnail Photo	thumbnailPhoto	string

Flow

Name	Path	Type	Description
Flow Name	name	string
properties	properties	FlowProperties

FlowProperties

Name	Path	Type	Description
Flow Display Name	displayName	string
Flow State	state	string
connectionReferences	connectionReferences	ConnectionReferencesDictionary
Flow Created Time	createdTime	date-time
Flow Modified Time	lastModifiedTime	date-time
Flow Template Name	templateName	string
Flow Trigger Uri	flowTriggerUri	string
Flow Installation Status	installationStatus	string

FlowListCallbackUrlResponse

Name	Path	Type	Description
Callback URL	response.value	string

FlowWithConnectionReferences

Name	Path	Type	Description
Flow Name	name	string
properties	properties	FlowWithConnectionReferencesProperties

FlowWithConnectionReferencesProperties

Name	Path	Type	Description
Flow Display Name	displayName	string
Flow State	state	string
connectionReferences	connectionReferences	ConnectionReferencesArray
Flow Created Time	createdTime	date-time
Flow Modified Time	lastModifiedTime	date-time
Flow Template Name	templateName	string
Flow Trigger Uri	flowTriggerUri	string
Flow Installation Status	installationStatus	string
creator	creator	UserIdentity
definitionSummary	definitionSummary	DefinitionSummary

AdminFlow

Name	Path	Type	Description
Flow Name	name	string
properties	properties	AdminFlowProperties

AdminFlowWithoutDefinition

Name	Path	Type	Description
Flow Name	name	string
properties	properties	AdminFlowWithoutDefinitionProperties

AdminFlowProperties

Name	Path	Type	Description
Flow Display Name	displayName	string
Flow State	state	string
connectionReferences	connectionReferences	ConnectionReferencesDictionary
Flow Created Time	createdTime	date-time
Flow Modified Time	lastModifiedTime	date-time
Flow Template Name	templateName	string
Flow Trigger Uri	flowTriggerUri	string
Flow Installation Status	installationStatus	string
creator	creator	UserIdentity
definitionSummary	definitionSummary	DefinitionSummary
estimatedSuspensionData	estimatedSuspensionData	EstimatedSuspensionData

AdminFlowWithoutDefinitionProperties

Name	Path	Type	Description
Flow Display Name	displayName	string
Flow State	state	string
Flow Created Time	createdTime	date-time
Flow Modified Time	lastModifiedTime	date-time

AdminFlowWithConnectionReferences

Name	Path	Type	Description
Flow Name	name	string
properties	properties	AdminFlowWithConnectionReferencesProperties

AdminFlowWithConnectionReferencesProperties

Name	Path	Type	Description
Flow Display Name	displayName	string
Flow State	state	string
connectionReferences	connectionReferences	ConnectionReferencesArray
Flow Created Time	createdTime	date-time
Flow Modified Time	lastModifiedTime	date-time
Flow Template Name	templateName	string
Flow Trigger Uri	flowTriggerUri	string
Flow Installation Status	installationStatus	string
creator	creator	UserIdentity
definitionSummary	definitionSummary	DefinitionSummary

EstimatedSuspensionData

Name	Path	Type	Description
Flow estimated suspension reason	reason	string
Flow estimated suspension time	time	date-time
If the flow is power app plan excluded or not	powerAppPlanExcluded	boolean

DefinitionSummary

Name	Path	Type	Description
triggers	triggers	array of object
Flow trigger type	triggers.type	string
Flow trigger kind	triggers.kind	string
actions	actions	array of object
Action type	actions.type	string
Swagger operation Id	actions.swaggerOperationId	string
Action Api name	actions.api.name	string
Action Api id	actions.api.id	string
Action Api type	actions.api.type	string

UserIdentity

Name	Path	Type	Description
Creator tenant ID	tenantId	string
Creator object ID	objectId	string
Creator user ID	userId	string
Creator user type	userType	string

Environment

Name	Path	Type	Description
Environment Name	name	string
Environment Location	location	string
properties	properties	EnvironmentProperties

EnvironmentProperties

Name	Path	Type	Description
Environment Display Name	displayName	string
Environment Description	description	string
Environment Created Time	createdTime	date-time
Environment Last Modified Time	lastModifiedTime	date-time
Environment Provisioning State	provisioningState	string
Environment Creation Type	creationType	string
Environment Sku	environmentSku	string
Environment Type	environmentType	string
Is Default Environment	isDefault	boolean

ConnectionReferencesArray

Name	Path	Type	Description
Items		ConnectionReference

ConnectionReferencesDictionary

ConnectionReference

Name	Path	Type	Description
Connection Name	connectionName	string
Connection Display Name	displayName	string
Connector Id	id	string
Either Embedded or Invoker connection	source	string
Logical name of the connection reference	connectionReferenceLogicalName	string
apiDefinition	apiDefinition	ApiWithoutConnectionParameters

ApiWithoutConnectionParameters

Name	Path	Type	Description
Connector Name	name	string
properties	properties	ApiPropertiesWithoutConnectionParameters

ApiPropertiesWithoutConnectionParameters

Name	Path	Type	Description
Connector Display Name	displayName	string
Connection Created Time	createdTime	date-time
Connector Runtime Url	primaryRuntimeUrl	string
Connector Icon Url	iconUri	string
Connector is Custom Api	isCustomApi	boolean
Connector Tier	tier	string

ConnectionWithoutConnectionParameters

Name	Path	Type	Description
Connection Name	name	string
properties	properties	ConnectionPropertiesWithoutConnectionParameters

ConnectionPropertiesWithoutConnectionParameters

Name	Path	Type	Description
Connector Display Name	displayName	string
Connector Id	apiId	string
Connection Created Time	createdTime	date-time
Connection Last Modified Time	lastModifiedTime	date-time