FireFly III icon

FireFly III

Read, update, write and delete data using the powerful FireFly III API

Actions89

Bills API → Create Bill

AI-generated

Overview

This node operation creates a new bill in the FireFly III system using the Bills API. It allows users to specify details such as the bill's name, minimum and maximum expected amounts, expected bill date, repeat frequency, and additional optional fields. This operation is useful for automating the management of recurring bills and financial planning within FireFly III.

Use Case Examples

  1. Automatically create monthly utility bills with specified minimum and maximum amounts and set them to repeat monthly.
  2. Add a new bill with notes and currency details for tracking expenses in different currencies.

Properties

Name Meaning
Name The name of the bill to be created.
Minimum Amount The minimum expected amount for the bill.
Maximum Amount The maximum expected amount for the bill.
Date The expected bill date in YYYY-MM-DD format.
Repeat Frequency How often the bill repeats (e.g., weekly, monthly, quarterly, half-year, yearly).
Additional Bill Fields Optional additional fields for the bill such as active status, currency code, notes, object group ID and title, and number of periods to skip.
X-Trace-ID A unique UUID identifier for the request, used for debugging and tracing.

Output

JSON

  • json - The JSON response from the FireFly III API containing the created bill's details.

Dependencies

  • An API key credential for FireFly III OAuth2 authentication is required to access the FireFly III API.

Troubleshooting

  • Ensure all required fields (Name, Minimum Amount, Maximum Amount, Date) are provided and correctly formatted.
  • Verify that the date is in the correct YYYY-MM-DD format.
  • Check that the API credentials are valid and have the necessary permissions to create bills.
  • If the API returns an error, review the error message for details such as invalid field values or missing required fields.
  • Use the X-Trace-ID for debugging and tracing requests if issues arise.

Links

Discussion