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
Tags API → Create Tag
AI-generatedOverview
This node operation creates a new tag in the FireFly III system using the Tags API. It is useful for users who want to organize and categorize their financial data by adding custom tags. For example, a user can create a tag named 'Vacation' to label all transactions related to travel expenses.
Use Case Examples
- Creating a new tag named 'Groceries' to categorize all grocery shopping transactions.
- Adding a tag with a specific date and description to mark a special event or budget period.
Properties
| Name | Meaning |
|---|---|
| X-Trace-ID | A unique UUID identifier for the request, used for debugging and tracing. |
| New Tag Name | The new name of the tag to be created, used in the API request body. |
| Extra Tag Options | Optional additional properties for the tag, including date and description. |
Output
JSON
json- The JSON response from the FireFly III API containing details of the created tag.
Dependencies
- Requires an API key credential for FireFly III OAuth2 authentication to access the FireFly III API.
Troubleshooting
- Ensure the 'New Tag Name' property is provided and not empty, as it is required.
- Verify that the API credentials are correctly configured and have the necessary permissions to create tags.
- Check the format of the 'Tag Date' if provided; it must be in YYYY-MM-DD format to avoid API errors.
- If the API returns an error, inspect the 'X-Trace-ID' for debugging and tracing the request in the FireFly III system.
Links
- FireFly III API Documentation - Create Tag - Official API documentation for creating tags in FireFly III.