YNAB icon

YNAB

Node for automating YNAB budget

Actions22

Overview

This node interacts with the YNAB (You Need A Budget) API to retrieve detailed information about a specific budget category. It is useful when you want to fetch data about a particular category either in general or for a specified month. For example, you might use this node to get the current status of a category's budget allocation or spending details for a given month.

Properties

Name Meaning
Category ID The unique identifier of the category you want to retrieve. This is required.
Additional Fields Optional extra parameters; currently supports specifying a month to get category data for that month only. The month is extracted from the provided date-time value.

Output

The node outputs a JSON object representing the requested category's data. If a month is specified, the output corresponds to the category data for that particular month; otherwise, it returns the general category information. The structure follows the YNAB API's category object format, including fields such as category name, budgeted amount, activity, and balance.

Dependencies

  • Requires an API key credential for authenticating requests to the YNAB API.
  • The node uses the base URL pattern https://api.ynab.com/v1/budgets/{budgetId}, where the budget ID is dynamically retrieved from credentials or configuration.
  • Uses the n8n helper method for authenticated HTTP requests.

Troubleshooting

  • Missing or invalid Category ID: Ensure the Category ID is correctly provided and exists in your YNAB budget.
  • Invalid month format: When specifying the month, provide a valid ISO 8601 date-time string. Only the month part will be used.
  • Authentication errors: Verify that the API key credential is set up correctly and has access to the specified budget.
  • API rate limits or network issues: These can cause request failures; check your network connection and YNAB API usage limits.

Links and References

Discussion