Actions55
- Webhooks Actions
- Payments Actions
- Products Actions
- Plans Actions
- Partner Referrals Actions
- Reporting Actions
- Orders Actions
- Subscriptions Actions
- Invoicing Actions
- Disputes Actions
Disputes → Escalate to Claim
AI-generatedOverview
The "Escalate to Claim" operation in the Disputes resource of this PayPal integration node allows users to escalate an existing dispute into a formal claim. This is typically used when a dispute cannot be resolved amicably and requires further investigation or resolution through PayPal's claims process.
This node is beneficial for merchants or customer service teams who want to automate the management of PayPal disputes within their workflows, enabling them to escalate disputes programmatically without manual intervention in the PayPal dashboard.
Practical example:
A merchant receives a chargeback dispute from a buyer. After attempting to resolve it, the merchant decides to escalate the dispute to a claim to provide additional evidence and trigger PayPal’s formal review process. Using this node operation, the escalation can be automated as part of a larger workflow that tracks dispute statuses and triggers notifications.
Properties
| Name | Meaning |
|---|---|
| ID | The unique identifier of the dispute to escalate to a claim. |
| Additional Options | Optional parameters including: - Environment: Choose between "Sandbox" or "Live". - Page Size: Number of items per page (for list operations). - Start Time: Filter start date (ISO 8601 format). - End Time: Filter end date (ISO 8601 format). |
Output
The node outputs a JSON object containing:
resource: The resource type, here always"disputes".operation: The operation performed, here"escalateToClaim".success: Boolean indicating if the operation was successful.- All fields returned by the PayPal API response for the escalate-to-claim endpoint, which typically includes details about the escalated claim.
creditsUsed: Number of API credits consumed by the operation (usually 1).creditsRemaining: Remaining API credits after the operation.timestamp: ISO string timestamp of when the operation was executed.
If the operation fails and "Continue On Fail" is enabled, the output will include an error message with success set to false.
Dependencies
- Requires valid credentials for:
- An API key credential for the external "N8N Tools API" service used for validation.
- A PayPal OAuth2 API credential providing an access token and environment configuration.
- The node makes HTTP requests to PayPal's REST API endpoints, using either the sandbox or live base URL depending on the selected environment.
- Proper configuration of these credentials in n8n is necessary for the node to function.
Troubleshooting
- Invalid ID: If the provided dispute ID does not exist or is malformed, the PayPal API will return an error. Ensure the ID is correct.
- Authentication errors: Missing or expired PayPal OAuth2 tokens will cause authentication failures. Refresh or reconfigure credentials as needed.
- API validation failure: If the external validation API rejects the request, check API key validity and network connectivity.
- Invalid JSON in request body: Although not applicable for this operation (no requestBody expected), other operations may fail if JSON input is malformed.
- Unknown operation or resource: Errors thrown if the operation or resource name is incorrect or unsupported.
- To resolve errors, verify all input parameters, credentials, and ensure the PayPal account has appropriate permissions.