Actions89
- General Actions
- About API Actions
- Accounts API Actions
- Available Budgets API Actions
- Bills API Actions
- Budgets API Actions
- Transactions API Actions
- Categories API Actions
- Tags API Actions
- Rules & Groups API Actions
- Piggy Banks API Actions
- Object Groups API Actions
- Recurrences API Actions
Categories API → Create Category
AI-generatedOverview
This node operation creates a new category in the FireFly III system using the Categories API. It is useful for users who want to organize their financial data by adding custom categories. For example, a user can create a category named 'Groceries' with notes describing it as 'Monthly grocery shopping expenses'.
Use Case Examples
- Create a new category named 'Utilities' to track utility bills.
- Add a category 'Entertainment' with notes for leisure expenses.
Properties
| Name | Meaning |
|---|---|
| X-Trace-ID | A unique UUID identifier for the request, used for debugging and tracing. |
| Name | The name of the category to be created. |
| Notes | Additional notes or description for the category. |
Output
JSON
json- The JSON response from the FireFly III API containing details of the created category.
Dependencies
- Requires an API key credential for FireFly III OAuth2 authentication to access the FireFly III API.
Troubleshooting
- Ensure the 'Name' property is provided as it is required; missing it will cause an error.
- Verify the X-Trace-ID is a valid UUID if used for tracing requests.
- Check API credentials and permissions if the API call fails with authentication errors.
- Handle API errors gracefully, such as network issues or invalid input data.
Links
- FireFly III API Documentation - Create Category - Official API documentation for creating a category in FireFly III.