YNAB icon

YNAB

Node for automating YNAB budget

Overview

This node integrates with the YNAB (You Need A Budget) API to automate budget management tasks. Specifically, the "Update Payee" operation allows users to update details of an existing payee in their YNAB budget. This is useful for keeping payee information current, such as correcting names or updating payee details after changes.

Practical examples include:

  • Renaming a payee to reflect a new business name.
  • Correcting typos in payee names to maintain consistent transaction records.
  • Updating payee information as part of automated bookkeeping workflows.

Properties

Name Meaning
Payee ID The unique identifier of the payee to update.
Name The new name to assign to the payee.

Output

The node outputs a JSON object representing the updated payee. This includes all standard payee fields as returned by the YNAB API after the update operation. The output structure corresponds to the payee resource schema from YNAB, typically including fields like id, name, and other payee metadata.

No binary data output is involved in this operation.

Dependencies

  • Requires an active connection to the YNAB API via an API key credential configured in n8n.
  • The node dynamically constructs the base URL using the budget ID obtained from credentials or configuration.
  • Uses HTTP requests authenticated with the provided API key to interact with YNAB endpoints.

Troubleshooting

  • Common issues:

    • Invalid or missing Payee ID will cause the API request to fail.
    • Providing an empty or invalid name may result in validation errors from the API.
    • Network connectivity problems or incorrect API keys will prevent successful updates.
  • Error messages:

    • Errors from the YNAB API typically include HTTP status codes and descriptive messages, e.g., "404 Not Found" if the payee does not exist.
    • Authentication failures will return 401 Unauthorized errors.
  • Resolutions:

    • Verify that the Payee ID is correct and exists in the specified budget.
    • Ensure the API key credential is valid and has appropriate permissions.
    • Confirm that the "Name" field is non-empty and properly formatted.
    • Check network connectivity and endpoint accessibility.

Links and References

Discussion