NetBird Full API Reference + Read-Only MCP Prototype
POST/api/integrations/okta-scim-idp

Create an Okta SCIM IDP integration

Creates a new Okta SCIM identity provider integration. Supply the required connection_name and any optional connector or group synchronization settings. The response includes the created integration and its authentication token.

  • IdempotentThe SDK sends Idempotency-Key, so a retried request is only applied once.

4 body fields

Okta SCIM identity provider integration configuration. connection_name is required.

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
connection_namestringrequired
The Okta enterprise connection name on Auth0

4 status codes
200Returns the created integration, including its identifier, enabled status, group prefixes, authentication token, 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
auth_tokenstringrequired
SCIM API token (full on creation/regeneration, masked on retrieval)
idintegerrequired
The unique identifier for the integration
last_synced_atstringrequired
Timestamp of the last synchronization
400Returned when the JSON is invalid, `connection_name` is missing, or a value fails validation.
messagestringoptional
A human-readable error message.
401Returned when authentication is missing or invalid.
messagestringoptional
A human-readable error message.
500Returned when an internal server error occurs.
messagestringoptional
A human-readable error message.

Error handling

connection_name is required; omitting it or sending invalid JSON or other invalid data returns a 400. Missing or invalid authentication returns a 401. A 500 indicates an internal server error.