YNAB

Interact with YNAB (You Need A Budget) API

Actions15

Budget Actions
Account Actions
Transaction Actions
Category Actions
- Get All
- Get
Payee Actions
- Get All
- Get

Overview

This node integrates with the YNAB (You Need A Budget) API to retrieve budget-related data. Specifically, the "Budget" resource with the "Get All" operation fetches all budgets accessible by the authenticated user. It optionally includes detailed account information for each budget.

Common scenarios where this node is useful include:

Retrieving a list of all budgets to display or process in workflows.
Fetching budgets along with their associated accounts to analyze financial structures.
Automating budget reporting or synchronization with other financial tools.

For example, a user might use this node to get all their budgets and then loop through each to generate monthly spending reports or to update another system with current budget details.

Properties

Name	Meaning
Include Accounts	Whether to include the list of budget accounts in the response. Options: `true` or `false`

Output

The output JSON contains an array of budget objects under the property path data.budgets. Each budget object represents a single budget with its details as provided by the YNAB API.

If the "Include Accounts" property is set to true, each budget object will also include an array of associated account objects, providing detailed account information within each budget.

No binary data is output by this node.

Dependencies

Requires an API key credential for authenticating with the YNAB API.
The node makes HTTP GET requests to the YNAB API endpoint at https://api.ynab.com/v1/budgets.
Proper configuration of the API key credential in n8n is necessary for successful authentication.

Troubleshooting

Authentication errors: If the node returns authentication failures, verify that the API key credential is correctly configured and has sufficient permissions.
Empty results: If no budgets are returned, ensure that the authenticated user actually has budgets in their YNAB account.
Invalid query parameter: Setting "Include Accounts" incorrectly may cause unexpected responses; it should be a boolean value.
API rate limits: Frequent calls to the YNAB API may hit rate limits; consider adding delays or error handling for rate limit responses.