Actions55
- Webhooks Actions
- Payments Actions
- Products Actions
- Plans Actions
- Partner Referrals Actions
- Reporting Actions
- Orders Actions
- Subscriptions Actions
- Invoicing Actions
- Disputes Actions
Webhooks → Create Webhook
AI-generatedOverview
This node enables comprehensive interaction with PayPal's API through a wide range of operations grouped by resource types such as Orders, Subscriptions, Invoicing, Disputes, Webhooks, and more. Specifically, for the Webhooks - Create Webhook operation, it allows users to create new webhook configurations in their PayPal account. This is useful for setting up event notifications from PayPal to your system, enabling automated workflows triggered by payment events, subscription changes, disputes, etc.
Practical examples include:
- Automatically receiving notifications when a payment is completed or refunded.
- Triggering downstream processes when a subscription is created or canceled.
- Monitoring dispute lifecycle events to automate customer support responses.
Properties
| Name | Meaning |
|---|---|
| Request Body | JSON object representing the webhook configuration details to be sent to PayPal when creating the webhook. |
| Additional Options | Collection of optional parameters: - Environment: "Sandbox" or "Live" PayPal environment. - Page Size: Number of items per page (used in list operations). - Start Time: ISO 8601 start date filter. - End Time: ISO 8601 end date filter. |
Output
The node outputs a JSON object containing:
resource: The resource type used ("webhooks").operation: The operation performed ("createWebhook").success: Boolean indicating if the operation succeeded.- All fields returned by the PayPal API response for the created webhook (e.g., webhook ID, URL, event types subscribed).
creditsUsedandcreditsRemaining: Numeric values indicating API usage credits consumed and remaining, provided by the external validation API.timestamp: ISO string timestamp of when the operation was executed.
No binary data output is produced by this node.
Dependencies
- Requires an API key credential for the external "N8N Tools API" service that validates operations and tracks credit usage.
- Requires OAuth2 credentials for PayPal API access, including an access token and environment selection (sandbox or live).
- The node makes HTTP requests to both the external validation API and the PayPal REST API endpoints.
Troubleshooting
- Invalid JSON in Request Body: If the request body JSON is malformed, the node throws an error indicating invalid JSON. Ensure the JSON syntax is correct.
- Validation Failure: If the external validation API rejects the operation, the node will throw an error with the validation message. Check API key validity and operation correctness.
- Unknown Operation or Resource: Errors occur if unsupported resource or operation names are used. Verify that "Webhooks" resource and "Create Webhook" operation are selected.
- API Authentication Errors: If PayPal OAuth2 credentials are missing or expired, API calls will fail. Refresh tokens or re-authenticate as needed.
- HTTP Request Failures: Network issues or incorrect endpoint URLs can cause failures. Confirm network connectivity and correct environment selection.