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

Update an Azure IDP integration

Updates an existing Azure AD identity provider integration. Supply only the optional fields you want to change, such as its enabled status, credentials, or synchronization settings. sync_interval, when provided, must be at least 300 seconds.

1 parameter · 8 body fields
idintegerrequired
The unique integer identifier of the Azure IDP integration to update.

Azure AD identity provider integration fields to update. All fields are optional.

enabledbooleanoptional
Whether the integration is enabled
connector_idstringoptional
DEX connector ID for embedded IDP setups
group_prefixesarray<string>optional
List of start_with string patterns for groups to sync
user_group_prefixesarray<string>optional
List of start_with string patterns for groups which users to sync
client_idstringoptional
Azure AD application (client) ID
client_secretstringoptional
Base64-encoded Azure AD client secret
sync_intervalintegeroptional
Sync interval in seconds (minimum 300)
tenant_idstringoptional
Azure AD tenant ID

5 status codes
200Returns the updated integration, including its identifier, configuration, enabled status, 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 JSON is invalid, the ID is invalid, or a field value fails validation.
messagestringoptional
A human-readable error message.
401Returned when the request is unauthorized.
messagestringoptional
A human-readable error message.
404Returned when the integration is not found.
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 identify an Azure IDP integration; an invalid ID or invalid request data returns a 400. An unauthorized request returns a 401, and an integration that cannot be found returns a 404. sync_interval must be at least 300 seconds when provided; a 500 indicates an internal server error.