Easy!Appointments

Overview

The Easy!Appointments n8n node allows you to interact with the Easy!Appointments API. Specifically, for the Service resource and the Create operation, this node enables you to create a new service in your Easy!Appointments system. This is useful for automating the management of services offered by your business, such as adding new types of appointments or offerings without manual entry.

Common scenarios:

• Automatically add new services when onboarding new offerings.
• Integrate with other systems (e.g., CRM, ERP) to sync available services.
• Batch-create services based on external data sources.

Example:
When a new product is added to your inventory system, automatically create a corresponding service in Easy!Appointments so customers can book it.

Properties

Fields within "Additional Fields":

Output

The output will be a JSON object representing the newly created service as returned by the Easy!Appointments API. The structure typically includes all the properties of the service, such as its name, duration, price, currency, description, location, category, availabilities type, and number of attendants, along with any additional metadata or IDs assigned by the system.

Example output:

{
  "id": "123",
  "name": "Consultation",
  "duration": 60,
  "price": 100,
  "currency": "EUR",
  "description": "A one-hour consultation.",
  "location": "Main Office",
  "categoryId": "cat1",
  "availabilitiesType": "standard",
  "attendantsNumber": 1,
  // ...other fields as provided by the API
}

Note: The exact output fields depend on the Easy!Appointments API response.

Dependencies

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

Troubleshooting

Common issues:

• Missing or incorrect credentials: Ensure the API URL, username, and password are correct and that the user has permission to create services.
• Base URL is required: If the base URL is missing from credentials, the node will throw an error.
• Validation errors: If required fields for the service are missing or invalid, the API may return an error message indicating which field is problematic.
• Network/connection errors: Make sure your n8n instance can reach the Easy!Appointments server.

Error messages:

• "Base URL is required": Set the correct URL in your credentials.
• API-specific errors (e.g., "Invalid data", "Unauthorized"): Check your input data and credentials.

Links and References

• Easy!Appointments Official Website
• Easy!Appointments GitHub Repository
• n8n Documentation: Creating Credentials
• n8n Documentation: Custom Nodes