identityApiConnector resource type

Namespace: microsoft.graph

Represents API connectors in a Microsoft Entra tenants.

An API connector used in your Microsoft Entra External ID self-service sign-up user flows allows you to call an API during the execution of the user flow. An API connector provides the information needed to call an API including an endpoint URL and authentication. An API connector can be used at a specific step in a user flow to affect the execution of the user flow. For example, the API response can block a user from signing up, show an input validation error, or overwrite user collected attributes.

Use the b2xIdentityUserFlow API to use an API connector from an External Identities self-service sign-up user flow.

Methods

Method	Return type	Description
List	identityApiConnector collection	Get a list of API connectors
Create	identityApiConnector	Create a new API connector.
Get	identityApiConnector	Read the properties of an identityApiConnector object.
Update	identityApiConnector	Update the properties of an API connector.
Upload client certificate	identityApiConnector	Upload a client certificate to use for authentication.
Delete	None	Delete an API connector.

Properties

Property	Type	Description
authenticationConfiguration	apiAuthenticationConfigurationBase	The object which describes the authentication configuration details for calling the API. Basic and PKCS 12 client certificate are supported.
displayName	String	The name of the API connector.
id	String	The randomly generated identifier of the API connector.
targetUrl	String	The URL of the API endpoint to call.

Relationships

None.

JSON representation

The following is a JSON representation of the resource.

{
  "@odata.type": "#microsoft.graph.identityApiConnector",
  "id": "String (identifier)",
  "displayName": "String",
  "targetUrl": "String",
  "authenticationConfiguration": {
    "@odata.type": "microsoft.graph.apiAuthenticationConfigurationBase"
  }
}