Easy!Appointments

Consume Easy!Appointments API

Actions38

Overview

The Easy!Appointments node for n8n allows you to interact with the Easy!Appointments API. Specifically, when using the Appointment resource and the Get operation, this node retrieves detailed information about a single appointment by its ID. This is useful in workflows where you need to fetch appointment details for further processing, notifications, reporting, or integration with other systems.

Practical examples:

  • Retrieve appointment details to send reminders or confirmations.
  • Fetch appointment data to synchronize with external calendars or CRM systems.
  • Use appointment information as part of automated follow-up processes.

Properties

Name Type Meaning
Appointment ID String The unique identifier of the appointment to retrieve. This is required.

Output

The output will be a JSON object containing all available details of the requested appointment. The exact structure depends on the Easy!Appointments API but typically includes fields such as:

{
  "id": "123",
  "start": "2024-06-10 09:00:00",
  "end": "2024-06-10 09:30:00",
  "location": "Main Office",
  "status": "confirmed",
  "customerId": "456",
  "providerId": "789",
  "serviceId": "1011",
  "notes": "Bring documents",
  // ...other appointment-specific fields
}

No binary data is returned; only structured JSON.

Dependencies

  • External Service: Requires access to an Easy!Appointments instance with its API enabled.
  • API Credentials: You must configure credentials in n8n under the name easyAppointmentsApi, including:
    • Base URL (without trailing slash)
    • Username
    • Password

Troubleshooting

Common issues:

  • Missing or incorrect Appointment ID: If the provided Appointment ID does not exist, the node will return an error from the API.
  • Invalid credentials or base URL: If the credentials are missing or incorrect, or if the base URL is not set properly, authentication will fail.
  • Network errors: Connectivity issues between n8n and the Easy!Appointments server can cause failures.

Error messages and resolutions:

  • "Base URL is required": Ensure the Easy!Appointments API credentials in n8n include a valid base URL.
  • "error": "Not Found": The specified Appointment ID does not exist. Double-check the ID.
  • Authentication errors: Verify that the username and password are correct and that the user has permission to access appointments.

Links and References

Discussion