identityApiConnector resource type

Namespace: microsoft.graph

Represents API connectors in an Azure Active Directory (Azure AD) tenants.

An API connector used in your Azure AD External Identities 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.


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.


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.



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"