YNAB icon

YNAB

Node for automating YNAB budget

Actions22

Overview

This node integrates with the YNAB (You Need A Budget) API to retrieve detailed information about a specific payee location by its unique ID. It is useful in scenarios where you want to automate budget management workflows that require fetching precise location data associated with payees, such as verifying transaction locations or enriching financial records with location details.

For example, if you have a transaction linked to a payee and need to get the exact location of that payee for reporting or auditing purposes, this node operation allows you to fetch that location data directly by specifying the location ID.

Properties

Name Meaning
Location ID The unique identifier of the payee location to retrieve. This is a required string input.

Output

The output JSON contains the full data object returned by the YNAB API for the specified payee location. This typically includes all relevant details about the location such as address, latitude/longitude coordinates, and any other metadata provided by YNAB for that location.

No binary data output is produced by this operation.

Dependencies

  • Requires an active connection to the YNAB API.
  • Requires an API authentication token credential configured in n8n to authorize requests.
  • The node dynamically constructs the base URL using the budget ID obtained from credentials or configuration.
  • Uses the httpRequestWithAuthentication helper method to perform authenticated HTTP GET requests to the YNAB API endpoint /payee_locations/{locationId}.

Troubleshooting

  • Invalid Location ID: If the provided Location ID does not exist or is malformed, the API will return an error. Ensure the Location ID is correct and exists within your YNAB budget.
  • Authentication Errors: If the API key or credentials are missing or invalid, the request will fail with an authentication error. Verify that the API key credential is properly set up and has access to the specified budget.
  • Budget ID Issues: The node relies on a valid budget ID to construct the API URL. If the budget ID is missing or incorrect, the request will fail. Confirm that the budget ID is correctly configured in the node's credentials or parameters.
  • Network or API Downtime: Network issues or YNAB API downtime can cause request failures. Check network connectivity and YNAB service status if errors persist.

Links and References

Discussion