PlaidInstall

Overview

This node integrates with the Plaid API to retrieve information about a user's financial item. Specifically, for the "Item" resource and "Get" operation, it fetches detailed metadata about a connected financial item using the provided access token. This can be useful in scenarios where you want to verify or inspect the status and details of a user's linked bank account or financial institution connection.

Practical examples include:

• Checking the status of a user's bank account connection.
• Retrieving institution and webhook information related to the item.
• Validating that an access token corresponds to an active item before performing further operations.

Properties

Output

The output is a JSON object containing detailed information about the Plaid item associated with the given access token. This typically includes fields such as the item's ID, institution details, webhook URL, available products, and status information.

Example structure (simplified):

{
  "item": {
    "item_id": "string",
    "institution_id": "string",
    "webhook": "string",
    "available_products": ["transactions", "auth", ...],
    "billed_products": ["transactions"],
    "error": null,
    ...
  }
}

No binary data is produced by this operation.

Dependencies

• Requires an API key credential for authenticating with the Plaid API (client ID and secret).
• The node uses HTTP requests to communicate with the Plaid API endpoints.
• No additional external dependencies beyond the Plaid API and proper credentials are needed.

Troubleshooting

• Common issues:

  • Invalid or expired access token: The node will fail if the access token is incorrect or no longer valid.
  • Network or API errors: Connectivity issues or Plaid service outages may cause request failures.
  • Missing or incorrect credentials: Ensure the API key credential is properly configured.

• Error messages:

  • Plaid API Error (error_code): error_message — Indicates a specific error returned by the Plaid API. Check the error code and message for details.
  • Plaid API Request Failed: message — General failure in making the API request, possibly due to network issues.

• Resolution tips:

  • Verify the access token is correct and has not been revoked.
  • Confirm that the API credentials (client ID and secret) are valid and have appropriate permissions.
  • Check network connectivity and retry if transient errors occur.
  • Enable "Continue On Fail" in the node settings to handle errors gracefully during batch processing.

Links and References

• Plaid API Documentation - Item Get
• Plaid Developer Portal
• n8n Documentation on Credentials