NetBird Full API Reference + Read-Only MCP Prototype
GET/api/integrations/notifications/channels

List Notification Channels

Retrieves all notification channels configured for the authenticated account.

6 status codes
200A list of notification channels.
enabledbooleanrequired
Whether this notification channel is active.
event_typesarray<string>required
List of activity event type codes this channel subscribes to.
idstringrequired
Unique identifier of the notification channel.
targetobjectoptional
Channel-specific target configuration. The shape depends on the `type` field: - `email`: an `EmailTarget` object - `webhook`: a `WebhookTarget` object
typestringrequired
The type of notification channel.
Allowed:emailwebhook
400Bad Request
401Requires authentication
403Forbidden
404Resource not found
500Internal Server Error

Error handling

A 400 is returned: Bad Request. A 401 is returned: Requires authentication. A 403 is returned: Forbidden. A 404 is returned: Resource not found. A 500 is returned: Internal Server Error.