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

Get a Google identity provider integration

Retrieves a Google identity provider integration by its unique identifier. Provide the numeric id of the integration whose details you need. The response includes its configuration and sync information.

1 parameter
idintegerrequired
The unique numeric identifier of the Google identity provider integration to retrieve.

5 status codes
200Returns the Google Workspace identity provider integration, including its identifier, customer ID, sync interval, enabled state, group prefixes, and last sync 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
customer_idstringrequired
Customer ID from Google Workspace
idintegerrequired
The unique identifier for the integration
last_synced_atstringrequired
Timestamp of the last synchronization
sync_intervalintegerrequired
Sync interval in seconds
400Returned when the integration ID has an invalid format.
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 identifier; an invalid format returns a 400. A 401 is returned when the request is unauthorized, a 404 when the integration does not exist, and a 500 when an internal server error occurs.