Actions15
Overview
This node interacts with the YNAB (You Need A Budget) API to retrieve information about a specific category within a budget. The "Category: Get" operation fetches details of a single category identified by its unique ID within a specified budget.
Common scenarios where this node is useful include:
- Retrieving detailed information about a particular budget category for reporting or analysis.
- Integrating YNAB category data into other financial tools or dashboards.
- Automating workflows that require category metadata, such as syncing category names or budgets.
For example, you might use this node to get the details of a category like "Groceries" in your monthly budget to display its current budgeted amount and activity in an external app.
Properties
| Name | Meaning |
|---|---|
| Budget ID | The unique identifier of the budget containing the category. |
| Category ID | The unique identifier of the category to retrieve details for. |
Output
The output JSON contains the details of the requested category under the json field. Specifically, the relevant data is found inside the data.category property returned by the YNAB API. This typically includes fields such as the category's name, budgeted amount, activity, balance, and other metadata related to the category.
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}/categories/{categoryId} - Proper configuration of the API key credential in n8n is necessary for successful authentication.
Troubleshooting
- Invalid Budget ID or Category ID: If either ID is incorrect or does not exist, the API will return an error indicating the resource was not found. Verify the IDs are correct.
- Authentication Errors: Missing or invalid API key credentials will cause authorization failures. Ensure the API key is valid and properly configured.
- Network Issues: Connectivity problems can prevent reaching the YNAB API. Check network access and proxy settings if applicable.
- Rate Limits: Excessive requests may trigger rate limiting by the YNAB API. Implement retries or backoff strategies if needed.