Actions55
- Webhooks Actions
- Payments Actions
- Products Actions
- Plans Actions
- Partner Referrals Actions
- Reporting Actions
- Orders Actions
- Subscriptions Actions
- Invoicing Actions
- Disputes Actions
Invoicing → Search Invoices
AI-generatedOverview
The node provides an enhanced integration with PayPal, supporting over 70 operations across multiple PayPal resources such as Orders, Subscriptions, Invoicing, Disputes, Webhooks, Payments, Products, Plans, Partner Referrals, and Reporting. Specifically, for the Invoicing resource and the Search Invoices operation, it allows users to search PayPal invoices based on various criteria like date ranges and pagination.
This node is beneficial in scenarios where automated invoice management is required within workflows, such as retrieving invoices matching specific filters for accounting, auditing, or customer service purposes. For example, a business could use this node to automatically fetch all invoices issued within a certain period to generate reports or trigger follow-up actions.
Properties
| Name | Meaning |
|---|---|
| Additional Options | Collection of optional parameters to refine the search: |
| - Environment: Choose between "Sandbox" (testing) or "Live" (production) PayPal environment. | |
| - Page Size: Number of invoices to return per page (default 20). | |
| - Start Time: ISO 8601 formatted start date to filter invoices from. | |
| - End Time: ISO 8601 formatted end date to filter invoices up to. |
Output
The output JSON object includes:
resource: The resource used, here always"invoicing".operation: The operation performed, here"searchInvoices".- The response body from PayPal's API containing the search results, which typically includes invoice details matching the search criteria.
success: Boolean indicating if the operation succeeded.creditsUsed: Number of API credits consumed by the request (from validation response).creditsRemaining: Remaining API credits after the request.timestamp: ISO timestamp when the response was generated.
No binary data output is produced by this operation.
Dependencies
- Requires valid credentials for:
- An API key credential for the external "N8N Tools" API that validates operations and tracks usage.
- A PayPal OAuth2 API credential providing an access token and environment information.
- The node makes HTTP requests to both the N8N Tools API and the PayPal REST API endpoints.
- Proper configuration of these credentials in n8n is necessary for successful execution.
Troubleshooting
- Invalid JSON in Request Body: If a malformed JSON string is provided in the request body parameter, the node will throw an error indicating invalid JSON. Ensure the JSON syntax is correct.
- Validation Failure: If the N8N Tools API validation fails, the node throws an error with the message returned by the validation endpoint. Check API key validity and permissions.
- Unknown Operation or Resource: Errors occur if unsupported operations or resources are specified. Confirm that the resource is set to "Invoicing" and operation to "Search Invoices".
- API Rate Limits or Quotas: The node tracks API credit usage; exceeding limits may cause failures. Monitor usage and adjust accordingly.
- Network or Authentication Issues: Failures connecting to PayPal or invalid OAuth tokens will cause errors. Verify network connectivity and refresh OAuth credentials if needed.