NetBird Full API Reference + Read-Only MCP Prototype
GET/api/integrations/azure-idp/{id}

Get an Azure IDP integration

Retrieves an Azure AD identity provider integration by its identifier. Use the integration's id to look up its configuration and synchronization details.

1 parameter
idintegerrequired
The unique integer identifier of the Azure IDP integration to retrieve.

5 status codes
200Returns the integration details, including its identifier, client and tenant IDs, host, synchronization settings, enabled status, group prefixes, and last synchronization time.
enabledbooleanrequired
Whether the integration is enabled
connector_idstringoptional
DEX connector ID for embedded IDP setups
group_prefixesarray<string>required
List of start_with string patterns for groups to sync
user_group_prefixesarray<string>required
List of start_with string patterns for groups which users to sync
client_idstringrequired
Azure AD application (client) ID
hoststringrequired
Azure host domain for the Graph API
idintegerrequired
The unique identifier for the integration
last_synced_atstringrequired
Timestamp of the last synchronization
sync_intervalintegerrequired
Sync interval in seconds
tenant_idstringrequired
Azure AD tenant ID
400Returned when the integration ID format is invalid.
messagestringoptional
A human-readable error message.
401Returned when the request is unauthorized.
messagestringoptional
A human-readable error message.
404Returned when no integration exists with the given ID.
messagestringoptional
A human-readable error message.
500Returned when an internal server error occurs.
messagestringoptional
A human-readable error message.

Error handling

The id path parameter must be a valid integer identifying the Azure IDP integration; an invalid ID format returns a 400. An unauthorized request returns a 401, and an integration that does not exist returns a 404. A 500 indicates an internal server error.