ActualBudget icon

ActualBudget

Consume ActualBudget API

Import Transactions

AI-generated

Overview

The ActualBudget node integrates with the ActualBudget API to manage budget data. Specifically, the 'Import Transactions' operation allows users to import a list of transactions into a specified account within a budget. This is useful for automating the process of adding financial transactions to a budget, such as importing bank transactions or expense records. For example, a user can provide a Budget ID, Account ID, and a JSON array of transactions to be imported into that account's budget.

Use Case Examples

  1. Import a batch of bank transactions into a budget account by providing the Budget ID, Account ID, and a JSON array of transaction objects with fields like date and amount.
  2. Automate expense tracking by importing daily transactions from a CSV or API source into the ActualBudget system.

Properties

Name Meaning
Budget ID The ID of the Budget you are working on/with, required for all operations.
Account ID The ID of the Account you are working on/with, required for importTransactions and getTransactions operations.
Transactions A JSON array of transaction objects to import, required for the importTransactions operation.

Output

JSON

  • success - Indicates if the import operation was successful
  • month - The month related to the import operation (if applicable)
  • categoryId - The category ID related to the budget amount set (if applicable)
  • amount - The budget amount in millicents (if applicable)

Dependencies

  • ActualBudget API key credential

Troubleshooting

  • Ensure the Budget ID and Account ID are correct and exist in your ActualBudget system.
  • Verify that the transactions JSON is properly formatted and contains required fields like date and amount.
  • Check for API authentication errors and ensure the ActualBudget API key credential is valid and has necessary permissions.
  • Handle errors returned by the API, such as invalid date formats or transaction data issues, by reviewing error messages and correcting input data.

Links

  • ActualBudget API Documentation - Official API documentation for ActualBudget, useful for understanding transaction import requirements and data formats.

Discussion