Actions98
- AccountingContact Actions
- Category Actions
- CheckAccount Actions
- CheckAccountTransaction Actions
- CommunicationWay Actions
- Contact Actions
- Contact Address Actions
- Contact Custom Field Actions
- Contact Custom Field Setting Actions
- Credit Note Actions
- Credit Note Po Actions
- Export Actions
- Update Export Config
- Export DATEV (Deprecated)
- Start DATEV CSV Zip Export
- Start DATEV XML Zip Export
- Generate Download Hash
- Get Progress
- Get Job Download Info
- Export Invoice as CSV
- Export Invoice as Zip
- Export Credit Note as CSV
- Export Voucher as CSV
- Export Voucher as Zip
- Export Transaction as CSV
- Export Contact as CSV
- Invoice Actions
- Invoice Position Actions
- Order Actions
- Order Position Actions
- Part Actions
- Report Actions
- Tag Actions
- Voucher Actions
- VoucherPo Actions
Tag → Create
AI-generatedOverview
This node integrates with the sevDesk API to manage tags associated with various objects such as invoices or contacts. Specifically, the "Tag - Create" operation allows users to create a new tag and associate it with a specified object within sevDesk. This is useful for organizing and categorizing entities in sevDesk by tagging them, which can improve searchability and filtering.
Practical examples include:
- Creating a tag named "Urgent" and associating it with an invoice to mark it for priority processing.
- Tagging a contact with "VIP" to highlight important clients.
Properties
| Name | Meaning |
|---|---|
| Name | The name of the tag to be created. |
| Object ID | The unique identifier of the object (e.g., invoice, contact) to which the tag will be linked. |
| Object Name | The type of the object to associate the tag with, such as "Invoice" or "Contact". |
Output
The node outputs JSON data representing the result of the tag creation operation. This typically includes details about the newly created tag and its association with the specified object. If an error occurs during execution, the output JSON will contain an error field describing the issue.
No binary data output is produced by this node.
Dependencies
- Requires an active connection to the sevDesk API via an API key credential.
- The node uses the base URL
https://my.sevdesk.de/api/combined with the API version specified in credentials. - Environment configuration validation is performed before execution to ensure necessary environment variables are set correctly.
Troubleshooting
Common issues:
- Invalid or missing API authentication token may cause authorization errors.
- Providing an incorrect or non-existent Object ID or Object Name will result in failure to associate the tag.
- Network connectivity problems can prevent communication with the sevDesk API.
Error messages:
- Errors returned from the API are captured and included in the output JSON under the
errorfield if "Continue On Fail" is enabled. - Validation errors related to environment configuration will be logged to the console at startup.
- Errors returned from the API are captured and included in the output JSON under the
Resolutions:
- Verify that the API key credential is correctly configured and has sufficient permissions.
- Double-check the Object ID and Object Name values for correctness.
- Ensure stable internet connectivity and that the sevDesk API endpoint is reachable.