Easy!Appointments

Consume Easy!Appointments API

Actions38

Service → Update

AI-generated

Overview

The Service → Update operation in the Easy!Appointments n8n node allows you to update an existing service in your Easy!Appointments system. This is useful for scenarios where you need to modify details of a service, such as its name, duration, price, or other attributes, directly from an automated workflow.

Common use cases:

  • Automatically updating service information when changes occur in another system (e.g., syncing with a CRM or booking platform).
  • Bulk-updating services based on business rules.
  • Integrating service management into larger automation processes.

Example:
If your company changes the price or duration of a service, you can use this node in an n8n workflow to update the service record in Easy!Appointments automatically.


Properties

Name Type Meaning
Service ID String The unique identifier of the service you want to update.
Additional Fields Object A collection of fields to update for the service. See below for available sub-fields.

Additional Fields options:

Name Type Meaning
Name String Name of the service.
Duration Number Duration of the service in minutes.
Price Number Price of the service.
Currency String Currency of the service price (e.g., "EUR").
Description String Description of the service.
Location String Location where the service is provided.
Category ID String ID of the category this service belongs to.
Availabilities Type String Type of availability for this service.
Attendants Number Number Number of attendants for this service.

Output

  • The output will be a JSON object representing the updated service as returned by the Easy!Appointments API.
  • The structure typically includes all service properties after the update (such as id, name, duration, price, etc.).
  • If an error occurs and "Continue On Fail" is enabled, the output will contain an error field with the error message.

Example output:

{
  "id": "123",
  "name": "Consultation",
  "duration": 45,
  "price": 100,
  "currency": "EUR",
  "description": "Updated description",
  "location": "Main Office",
  "categoryId": "5",
  "availabilitiesType": "standard",
  "attendantsNumber": 2
}

Note: Actual fields depend on the Easy!Appointments API response.


Dependencies

  • Easy!Appointments API: You must have access to an Easy!Appointments instance with API enabled.
  • API Credentials: Requires an n8n credential named easyAppointmentsApi containing:
    • Base URL (url)
    • Username (username)
    • Password (password)
  • No additional environment variables are required beyond standard n8n configuration.

Troubleshooting

Common issues:

  • Invalid Service ID: If the provided Service ID does not exist, the API will return an error.
  • Missing Required Fields: If required fields are missing or invalid, the API may reject the request.
  • Authentication Errors: Incorrect credentials will result in authentication failures.
  • Base URL Issues: If the base URL is missing or incorrect, requests will fail.

Error messages:

  • "Base URL is required": Ensure the Easy!Appointments API credential has a valid URL.
  • "401 Unauthorized" or similar: Check your username and password in the credentials.
  • "404 Not Found": The specified Service ID does not exist.
  • "Validation failed" or similar: One or more fields in Additional Fields are invalid.

How to resolve:

  • Double-check the Service ID and ensure it exists in your Easy!Appointments system.
  • Verify that all required fields are filled out correctly.
  • Confirm your API credentials are correct and have sufficient permissions.
  • Make sure the base URL points to the correct Easy!Appointments API endpoint.

Links and References

Discussion