Actions55
- Webhooks Actions
- Payments Actions
- Products Actions
- Plans Actions
- Partner Referrals Actions
- Reporting Actions
- Orders Actions
- Subscriptions Actions
- Invoicing Actions
- Disputes Actions
Disputes → Update Dispute
AI-generatedOverview
The "Update Dispute" operation in the N8N Tools - PayPal Enhanced node allows users to update information related to a specific PayPal dispute. This is useful for merchants or support teams who need to modify dispute details, such as adding comments or changing dispute status, directly from an automated workflow.
Typical scenarios include:
- Updating dispute status or notes after reviewing customer claims.
- Automating dispute management workflows by integrating with other systems.
- Keeping dispute records synchronized between PayPal and internal databases.
Example: A merchant receives a dispute notification and uses this node to update the dispute with additional evidence or comments before escalating it.
Properties
| Name | Meaning |
|---|---|
| ID | The unique identifier of the dispute to update. |
| Request Body | JSON-formatted string containing the fields and values to update on the dispute resource. |
| Additional Options | Optional parameters including: • Environment: "Sandbox" or "Live" PayPal environment. • Page Size: Number of items per page (for 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, here always"disputes".operation: The operation performed, here"updateDispute".success: Boolean indicating if the operation succeeded.- All fields returned by the PayPal API response for the updated dispute.
creditsUsed: Number of API credits consumed by the request.creditsRemaining: Remaining API credits after the request.timestamp: ISO timestamp when the operation was executed.
No binary data output is produced by this operation.
Dependencies
- Requires valid credentials for:
- An API key credential for the external N8N Tools API used for validation.
- A PayPal OAuth2 access token credential for authenticating requests to PayPal's REST API.
- The node dynamically selects the PayPal API base URL based on the chosen environment ("sandbox" or "live").
- The node sends HTTP PATCH requests to the PayPal endpoint
/v1/customer/disputes/{id}to perform updates.
Troubleshooting
- Invalid JSON in Request Body: If the JSON provided in the "Request Body" property is malformed, the node will throw an error indicating invalid JSON. Ensure the JSON syntax is correct.
- Unknown Resource or Operation: Errors occur if the resource or operation names are incorrect or unsupported. Confirm that "Disputes" is selected as the resource and "Update Dispute" as the operation.
- API Validation Failure: The node first validates the operation via an external API. If validation fails, check API key credentials and network connectivity.
- Authorization Errors: If the PayPal OAuth2 token is invalid or expired, the request will fail. Refresh or reauthenticate the PayPal credentials.
- HTTP Errors from PayPal: Any errors returned by PayPal (e.g., 4xx or 5xx responses) will cause the node to throw an error with the message from PayPal. Review the error message for details and adjust the request body accordingly.