Actions21
Overview
This node integrates with the Easy!Appointments API to manage appointment data. Specifically, for the Appointment - Create operation, it allows users to create new appointments by specifying details such as start and end times, customer, provider, and service involved. This is useful in scenarios where automated scheduling or calendar management is needed, such as booking client meetings, medical appointments, or service sessions.
Practical examples include:
- Automatically creating an appointment when a form is submitted on a website.
- Scheduling follow-up meetings based on CRM triggers.
- Integrating with other systems to synchronize appointment data.
Properties
| Name | Meaning |
|---|---|
| Start Date Time | The start date and time of the appointment. |
| End Date Time | The end date and time of the appointment. |
| Customer ID | The numeric ID of the customer for whom the appointment is being created. |
| Provider ID | The numeric ID of the provider who will handle the appointment. |
| Service ID | The numeric ID of the service associated with the appointment. |
| Additional Fields | Optional extra fields to specify more details about the appointment: |
| - Location | The location where the appointment will take place (string). |
| - Color | The color code representing the appointment in the calendar (color picker, default black). |
| - Status | The status of the appointment; options are: Booked, Cancelled, Confirmed. |
| - Notes | Any additional notes or comments about the appointment (multi-line string). |
Output
The node outputs JSON data representing the created appointment record as returned by the Easy!Appointments API. This typically includes all appointment details such as IDs, timestamps, status, and any additional metadata provided by the API.
No binary data output is produced by this operation.
Dependencies
- Requires an active connection to the Easy!Appointments API.
- Needs an API authentication token or key configured in n8n credentials to authorize requests.
- The base URL for the Easy!Appointments instance must be set in the node credentials.
Troubleshooting
- Invalid or missing required fields: Ensure that all mandatory properties (start, end, customerId, providerId, serviceId) are provided and correctly formatted.
- API authentication errors: Verify that the API key or token is valid and has sufficient permissions.
- Date/time format issues: Use ISO 8601 compliant date-time strings for start and end times.
- JSON parsing errors: If using additional fields with complex data, ensure proper formatting.
- Network or connectivity problems: Check the base URL and network access to the Easy!Appointments server.
Common error messages may include:
- "Missing required parameter" — check that all required inputs are filled.
- "Unauthorized" or "Authentication failed" — verify API credentials.
- "Invalid date format" — correct the date-time input format.
Links and References
- Easy!Appointments Official Website
- Easy!Appointments API Documentation (if available)
- n8n documentation on HTTP Request Node for understanding API calls in custom nodes.