Actions14
Overview
This node integrates with an external appointment management API to create new appointments (agendamentos). It allows users to schedule appointments by specifying details such as title, description, start and end times, status, priority, associated client, and consultation price. This node is useful in scenarios where businesses or service providers need to automate the creation of appointments within their scheduling system, for example:
- A medical clinic automatically creating patient appointments from form submissions.
- A consultancy firm scheduling client meetings based on CRM triggers.
- Any service-based business managing bookings programmatically.
By using this node, users can streamline appointment creation workflows, ensuring data consistency and reducing manual entry.
Properties
| Name | Meaning |
|---|---|
| Título | Title of the appointment. |
| Descrição | Description of the appointment (optional). |
| Data/Hora Início | Start date and time of the appointment (required). |
| Data/Hora Fim | End date and time of the appointment (required). |
| Status | Status of the appointment. Options: "Agendado" (Scheduled), "Confirmado" (Confirmed), "Concluído" (Completed), "Cancelado" (Cancelled). Default is "Agendado". |
| Client ID (Opcional) | Optional ID of the client associated with the appointment. |
| Preço da Consulta | Consultation price in format like "150.00" (optional). |
| Prioridade | Priority of the appointment. Options: "Normal", "Alta" (High), "Baixa" (Low). Default is "Normal". |
Output
The node outputs a JSON object representing the created appointment as returned by the external API. The structure typically includes all the appointment details sent during creation along with any additional metadata or identifiers assigned by the API.
If the API supports it, the output may include fields such as appointment ID, timestamps, status confirmation, and linked client information.
No binary data output is produced by this node.
Dependencies
- Requires an API key credential for authenticating requests to the external appointment management API.
- The node expects the API base URL and API key to be configured in the credentials.
- Network connectivity to the external API endpoint is necessary.
Troubleshooting
Common Issues:
- Missing required fields such as title, start time, or end time will cause errors.
- Invalid date/time formats may lead to request failures.
- Incorrect or expired API keys will result in authentication errors.
- Providing a non-existent client ID may cause the API to reject the request.
Error Messages:
"Unknown operation: appointment.create": Indicates a misconfiguration in the operation parameter; ensure "Create" is selected.- HTTP 401 Unauthorized: Check that the API key credential is correctly set and valid.
- Validation errors from the API usually specify which field is invalid or missing; review input properties accordingly.
Resolution Tips:
- Double-check all required inputs before execution.
- Verify API credentials and permissions.
- Consult the external API documentation for specific error codes and messages.
Links and References
- Gestor Clientes Max API Documentation (Replace with actual API docs link if available)
- n8n Documentation on Creating Custom Nodes
- General best practices for Date and Time Handling