Actions15
Overview
This node integrates with the YNAB (You Need A Budget) API to retrieve information about accounts within a specified budget. Specifically, the "Account - Get" operation fetches details of a single account by its ID from a given budget. This is useful for users who want to programmatically access detailed account data such as balances, account type, and other metadata stored in their YNAB budgets.
Practical examples include:
- Retrieving an account's current balance and details to display in a custom dashboard.
- Automating financial reports that require up-to-date account information.
- Syncing account data with other financial tools or databases.
Properties
| Name | Meaning |
|---|---|
| Budget ID | The unique identifier of the budget containing the account. |
| Account ID | The unique identifier of the specific account to retrieve within the specified budget. |
Output
The output JSON contains the detailed information of the requested account under the json field. The structure corresponds to the YNAB API's account object, typically including fields such as:
id: Account identifier.name: Account name.type: Type of account (e.g., checking, savings).balance: Current balance in milliunits.- Other metadata related to the account.
No binary data output is involved in this operation.
Dependencies
- Requires an API key credential for authenticating requests to the YNAB API.
- The node makes HTTP GET requests to the YNAB API endpoint:
https://api.ynab.com/v1/budgets/{budgetId}/accounts/{accountId}. - Proper configuration of the API key credential in n8n is necessary.
Troubleshooting
Common issues:
- Invalid or missing Budget ID or Account ID parameters will cause the request to fail.
- Incorrect or expired API key credentials will result in authentication errors.
- Network connectivity problems can prevent successful API calls.
Error messages and resolutions:
- 401 Unauthorized: Check that the API key credential is correctly set and has proper permissions.
- 404 Not Found: Verify that both the Budget ID and Account ID are correct and exist in your YNAB account.
- 400 Bad Request: Ensure all required parameters are provided and valid.
- Network errors: Confirm internet connectivity and that the YNAB API service is reachable.