Payhawk icon

Payhawk

Interact with the Zitadel API

Actions99

Webhook Subscriptions → Get Webhook Subscriptions

AI-generated

Overview

This node operation retrieves webhook subscriptions associated with a specific account. It is useful for scenarios where you need to list or manage the webhooks that are currently registered for an account, such as monitoring active webhook endpoints or auditing webhook configurations.

Practical examples include:

  • Fetching all webhook subscriptions to display them in a dashboard.
  • Verifying if a particular webhook subscription exists before creating a new one.
  • Automating cleanup or updates of webhook subscriptions based on current active ones.

Properties

Name Meaning
Account Id Identifier of the account whose webhook subscriptions you want to retrieve

Output

The output will contain a JSON object representing the webhook subscriptions retrieved for the specified account. This typically includes details such as webhook URLs, event types subscribed to, status, and other metadata related to each webhook subscription.

No binary data output is expected from this operation.

Dependencies

  • Requires an API key credential or similar authentication token configured in n8n to access the external service's API.
  • The node depends on the external service's API endpoint that manages webhook subscriptions.
  • Proper base URL configuration and authentication credentials must be set up in n8n for successful API communication.

Troubleshooting

  • Common issues:

    • Invalid or missing Account Id property will cause the request to fail.
    • Authentication errors due to missing or incorrect API credentials.
    • Network connectivity problems preventing access to the external API.
    • API rate limits or permission restrictions may block retrieval of webhook subscriptions.
  • Error messages and resolutions:

    • "Unauthorized" or "Authentication failed": Check that the API key or authentication token is correctly configured and has sufficient permissions.
    • "Account not found": Verify that the provided Account Id is correct and exists in the external system.
    • "Network error": Ensure that n8n server has internet access and the external API endpoint is reachable.
    • "Rate limit exceeded": Wait and retry after some time or adjust usage to comply with API limits.

Links and References

  • Refer to the external service’s official API documentation for webhook subscription management.
  • n8n documentation on setting up API credentials and HTTP request nodes for further customization.

Discussion