Back to Novu

List all channel endpoints

docs/api-reference/channel-endpoints/list-all-channel-endpoints.mdx

3.19.0789 B
Original Source

List channel endpoints for your environment. Filter by subscriberId, integrationIdentifier, channel, providerId, and other query parameters supported by the API.

List tool_webhook endpoints

Fetch every Tool Webhook destination registered for a subscriber on a dynamic integration:

bash
curl -L 'https://api.novu.co/v1/channel-endpoints?subscriberId=user-123&integrationIdentifier=tool-webhook' \
-H 'Authorization: ApiKey <NOVU_SECRET_KEY>'

Each item with type: "tool_webhook" includes the decrypted wire shape { url, headers?, method? }. A subscriber may have multiple rows for the same integration — one per registered destination URL.

See the Tool Webhook setup guide for creating and managing dynamic endpoints.