ADVBOX icon

ADVBOX

Consume Advbox API

Actions14

Overview

This node integrates with the Advbox API to manage tasks related to legal cases (lawsuits). Specifically, the Task - Create operation allows users to create a new task associated with a lawsuit. This is useful in legal case management workflows where tasks need to be assigned, tracked, and scheduled for different users involved in a lawsuit.

Typical use cases include:

  • Assigning a new task to a user responsible for a specific lawsuit.
  • Inviting guest users to collaborate on the task.
  • Scheduling tasks with start dates, deadlines, and optional times.
  • Marking tasks as urgent or important and deciding whether they should appear in a calendar view.

For example, a legal assistant could automate the creation of follow-up tasks for a lawsuit, assign them to responsible lawyers, and notify guest collaborators.

Properties

Name Meaning
From User ID ID of the user creating the task (selectable from loaded users).
Guest Users List of users invited as guests to the task; can select multiple users or provide an array expression of user IDs.
Task Type of the task to create (selectable from loaded task types).
Lawsuit ID ID of the lawsuit associated with this task (string input).
Start Date Start date of the task in DD/MM/YYYY format (string).
Additional Fields Collection of optional fields:
- Comments Comments about the task (string).
- Start Time Start time of the task in HH:MM format (string).
- End Date End date of the task in DD/MM/YYYY format (string).
- End Time End time of the task in HH:MM format (string).
- Deadline Date Deadline date of the task in DD/MM/YYYY format (string).
- Location Location of the task (string).
- Urgent Boolean flag indicating if the task is urgent.
- Important Boolean flag indicating if the task is important.
- Display in Schedule Boolean flag indicating if the task should be displayed in the calendar.

Output

The node outputs JSON data representing the created task as returned by the Advbox API. The output includes all details of the newly created task, such as its ID, associated lawsuit, assigned users, scheduling information, comments, and flags like urgency or importance.

No binary data output is produced by this operation.

Dependencies

  • Requires an API key credential for authenticating with the Advbox API.
  • The node uses the Advbox API base URL and token configured in the credentials.
  • It depends on the Advbox API endpoints /posts for creating tasks and /settings for loading options like users and task types.
  • The node expects valid user IDs, task type IDs, and lawsuit IDs that exist in the Advbox system.

Troubleshooting

  • Missing or invalid API token: The node will throw an error if the API token is not provided or invalid. Ensure the API key credential is correctly set up.
  • Invalid date/time formats: Dates must be in DD/MM/YYYY and times in HH:MM format. Incorrect formats may cause API errors.
  • Required fields missing: The operation requires From User ID, Guest Users, Task, Lawsuit ID, and Start Date. Omitting these will result in errors.
  • Empty comments field warning: If the comments field is empty or missing, the node logs a warning but still proceeds. Providing meaningful comments is recommended.
  • API request failures: Network issues or incorrect endpoint URLs can cause request failures. Check connectivity and API URL configuration.
  • User and task type loading issues: If the node cannot load users or task types for selection, verify API access permissions and that the /settings endpoint returns expected data.

Links and References

If you need further details on other operations or resources, feel free to ask!

Discussion