Easy!Appointments

Consume Easy!Appointments API

Actions38

Overview

The Easy!Appointments n8n node allows you to interact with the Easy!Appointments API. Specifically, for the Settings resource and the Update operation, this node enables you to update various global configuration settings of your Easy!Appointments instance, such as company information, appearance, and scheduling preferences.

Common scenarios:

  • Updating company branding (name, email, logo) in your appointment system.
  • Changing scheduling defaults like date/time formats or working plans.
  • Enabling/disabling features such as requiring phone numbers for appointments.

Practical example:
You could use this node in an automation workflow to synchronize company details from another system (like a CRM) into Easy!Appointments whenever those details change.

Properties

Name Type Meaning
Company Name String Name of the company displayed in Easy!Appointments.
Company Email String Contact email address for the company.
Company Logo String URL to the company's logo image.
Company Working Plan String Company's default working plan in JSON format.
Google Analytics ID String Google Analytics tracking ID for analytics integration.
Date Format String Format for displaying dates (e.g., "DMY", "MDY", "YMD").
Time Format String Format for displaying time (e.g., "regular", "military").
First Weekday String The first day of the week ("sunday" or "monday").
Require Phone Number Boolean Whether a phone number is required when booking appointments.
Display Any Provider Boolean Whether to show an "Any Provider" option during appointment booking.
Appointment Color String Default color code for appointments in the calendar.
Unavailability Color String Default color code for unavailabilities in the calendar.

Output

  • The output will be a JSON object reflecting the updated settings as returned by the Easy!Appointments API.
  • The structure typically mirrors the fields sent, possibly including additional metadata or confirmation from the API.

Example output:

{
  "company_name": "Acme Corp",
  "company_email": "info@acme.com",
  "company_logo": "https://example.com/logo.png",
  "company_working_plan": "{\"monday\":{\"start\":\"09:00\",\"end\":\"17:00\"}}",
  "google_analytics_id": "UA-XXXXXX-X",
  "date_format": "DMY",
  "time_format": "regular",
  "first_weekday": "monday",
  "require_phone_number": true,
  "display_any_provider": false,
  "appointment_color": "#FF0000",
  "unavailability_color": "#CCCCCC"
}

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 authentication error.
  • Invalid field values: Supplying invalid data (e.g., malformed JSON for the working plan) may result in API errors.
  • No fields provided: If no fields are set in "Additional Fields," the API may reject the request or not update anything.

Error messages and resolutions:

  • "Base URL is required": Ensure the Easy!Appointments API URL is correctly set in your credentials.
  • "Authentication failed": Double-check your username and password.
  • "400 Bad Request" or similar: Review the data types and formats of your input fields, especially for complex fields like "Company Working Plan."

Links and References

Discussion