Easy!Appointments

Consume Easy!Appointments API

Actions38

Overview

The Easy!Appointments node for n8n allows you to interact with the Easy!Appointments API, specifically to manage customer records.
For the Customer → Create operation, this node enables you to create a new customer in your Easy!Appointments system by sending relevant customer details.

Common scenarios:

  • Automating the onboarding of new customers from web forms or CRM systems into Easy!Appointments.
  • Integrating customer creation as part of a larger workflow (e.g., after a successful payment or registration).
  • Keeping customer data synchronized between Easy!Appointments and other business tools.

Practical example:
When a user fills out a signup form on your website, you can use this node to automatically add their information as a new customer in Easy!Appointments.

Properties

Name Type Meaning
Additional Fields Collection A group of optional fields to specify customer details. See below for available options.

Fields within "Additional Fields":

Name Type Meaning
First Name String First name of the customer
Last Name String Last name of the customer
Email String Email of the customer
Phone String Phone number of the customer
Address String Address of the customer
City String City of the customer
ZIP String ZIP code of the customer
Timezone String Timezone of the customer
Language String Language of the customer
Notes String Notes for the customer
Custom Field 1 String Custom field 1
Custom Field 2 String Custom field 2
Custom Field 3 String Custom field 3
Custom Field 4 String Custom field 4
Custom Field 5 String Custom field 5
LDAP DN String LDAP DN of the customer

Output

The output will be a JSON object representing the newly created customer as returned by the Easy!Appointments API.
The structure of this object depends on the API's response, but typically includes all submitted fields plus additional metadata such as the customer ID and timestamps.

Example output:

{
  "id": 123,
  "firstName": "John",
  "lastName": "Doe",
  "email": "john.doe@example.com",
  "phone": "+1234567890",
  "address": "123 Main St",
  "city": "Sampletown",
  "zip": "12345",
  "timezone": "Europe/Berlin",
  "language": "en",
  "notes": "VIP customer",
  "customField1": "",
  "customField2": "",
  "customField3": "",
  "customField4": "",
  "customField5": "",
  "ldapDn": "",
  "created_at": "2024-06-01T12:00:00Z",
  "updated_at": "2024-06-01T12:00:00Z"
}

Note: The actual fields may vary depending on the API version and configuration.

Dependencies

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

Troubleshooting

Common issues:

  • Missing or incorrect credentials: If the base URL, username, or password are missing or incorrect, the node will throw an error such as "Base URL is required" or authentication errors.
  • Invalid input data: If required fields for the customer are not provided or are invalid, the API may return validation errors.
  • Network issues: Connectivity problems between n8n and the Easy!Appointments server can cause request failures.

Error messages and resolutions:

  • "Base URL is required": Ensure that the Easy!Appointments API base URL is set correctly in your credentials.
  • "Authentication failed" or similar: Double-check your username and password in the credentials.
  • "400 Bad Request" or validation errors: Review the data sent in "Additional Fields" for missing or malformed values.

Links and References

Discussion