N8N Tools - PayPal Enhanced icon

N8N Tools - PayPal Enhanced

Complete PayPal integration with 70+ operations including Orders, Subscriptions, Invoicing, Disputes, Webhooks, and Partner management

Actions55

Webhooks → List Event Subscriptions

AI-generated

Overview

This node provides enhanced integration with PayPal, supporting a wide range of operations across multiple PayPal resources. Specifically for the Webhooks resource and the List Event Subscriptions operation, it allows users to retrieve the list of event types (subscriptions) associated with a specific webhook ID.

This is useful in scenarios where you want to programmatically manage or audit which events a particular webhook is subscribed to, such as verifying webhook configurations or dynamically adjusting workflows based on webhook event subscriptions.

Practical example:
You have set up webhooks to receive notifications about payment events. Using this node operation, you can list all event types that a webhook is currently subscribed to, ensuring your webhook listens only to relevant events and helping debug notification issues.

Properties

Name Meaning
ID The unique identifier of the webhook for which to list event subscriptions.
Additional Options Collection of optional parameters:
- Environment PayPal environment to use: Sandbox or Live.
- Page Size Number of items per page for list operations (pagination).
- Start Time Filter start date/time in ISO 8601 format to limit results.
- End Time Filter end date/time in ISO 8601 format to limit results.

Output

The output JSON object includes:

  • resource: The resource name, here always "webhooks".
  • operation: The operation performed, here "listEventSubscriptions".
  • success: Boolean indicating if the operation succeeded.
  • The response body from PayPal API listing event subscriptions for the specified webhook.
  • creditsUsed: Number of API credits consumed by the request (from validation API).
  • creditsRemaining: Remaining API credits after the request (from validation API).
  • timestamp: ISO string timestamp when the response was generated.

The exact structure of the event subscriptions data depends on PayPal's API response but typically includes event type names and descriptions.

No binary data output is produced by this operation.

Dependencies

  • Requires an API key credential for the external "N8N Tools API" service used for validating requests and tracking usage.
  • Requires a PayPal OAuth2 API credential providing:
    • Access token for authenticating PayPal API calls.
    • Environment setting (sandbox or live).
    • Client ID (used in validation).
  • The node makes HTTP requests to both the N8N Tools API and PayPal REST API endpoints.
  • Proper configuration of these credentials in n8n is necessary before using the node.

Troubleshooting

  • Invalid JSON in Request Body: If a JSON input is malformed, the node throws an error indicating invalid JSON. Ensure JSON inputs are correctly formatted.
  • Validation Failure: If the N8N Tools API validation fails, the node will throw an error with the message returned by the validation endpoint. Check API key validity and client ID correctness.
  • Unknown Operation or Resource: Errors occur if unsupported operations or resources are selected. Verify that the operation matches the resource and is supported.
  • HTTP Request Failures: Network issues, expired PayPal tokens, or incorrect environment settings may cause HTTP errors. Refresh credentials and verify environment selection.
  • Pagination Parameters: If large result sets are expected, use Page Size, Start Time, and End Time options to control the volume and filtering of data.

Links and References

Discussion