Imobzi icon

Imobzi

Interagir com a API da Imobzi
Join our community

Actions62

Overview

This node integrates with the Imobzi API to manage agenda items. Specifically, the "Update" operation for the "Agenda" resource allows users to modify existing agenda entries by specifying their ID and updating selected fields. This is useful in scenarios where you need to programmatically adjust details of scheduled events or appointments stored in Imobzi, such as changing the date, title, description, or contact information associated with an agenda item.

Practical examples include:

  • Updating the date or time of a meeting.
  • Changing the title or description of an appointment.
  • Modifying contact details like email or phone number related to an agenda entry.
  • Adjusting the value or priority of an agenda item.

Properties

Name Meaning
Agenda Name or ID Select an existing agenda item from a list or specify its ID via expression.
Update Fields Collection of fields to update on the agenda item. Includes:
- Date The date of the agenda item (string).
- Description A textual description of the agenda item.
- Email Email address associated with the agenda item.
- Name Name of the agenda item.
- Phone Phone number related to the agenda item.
- Title Title of the agenda item.
- Value Numeric value associated with the agenda item.

Output

The node outputs a JSON object representing the updated agenda item as returned by the Imobzi API. The structure includes all fields of the agenda item after the update, reflecting the changes made.

If the API returns data under a data property, that is extracted; otherwise, the full response is used. There is no binary output.

Example output JSON snippet:

{
  "id": "123",
  "date": "2024-07-01",
  "title": "Updated Meeting",
  "description": "Discuss project updates",
  "email": "contact@example.com",
  "phone": "1234567890",
  "name": "Project Meeting",
  "value": 100
}

Dependencies

  • Requires an API key credential configured in n8n to authenticate requests to the Imobzi API.
  • The node uses the Imobzi REST API endpoints corresponding to agendas (/agendas).
  • No additional external dependencies beyond the configured API authentication.

Troubleshooting

  • Common issues:

    • Providing an invalid or non-existent agenda ID will result in an error from the API.
    • Omitting required fields or providing empty update fields may cause the API to reject the request or make no changes.
    • Network or authentication failures can prevent successful API calls.

  • Error messages:

    • "Resource 'agenda' not supported!" — indicates an unsupported resource was specified; ensure "agenda" is selected.
    • "Operation 'update' not supported!" — indicates an unsupported operation; verify the operation is set to "update".
    • API errors related to invalid IDs or missing permissions will be passed through; check the API response message for details.

  • Resolution tips:

    • Verify the agenda ID exists by using the "Get" or "Get Many" operations before updating.
    • Ensure the API key credential is valid and has sufficient permissions.
    • Provide at least one field to update in the "Update Fields" collection.

Links and References

Discussion