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 Category resource and the Update operation, this node updates an existing category in your Easy!Appointments system. This is useful for workflows where you need to programmatically change category details (such as name or description) based on other automation steps.

Practical scenarios:

  • Automatically updating a service category's name or description after receiving new information from another system.
  • Keeping category metadata synchronized between Easy!Appointments and external databases or CRMs.
  • Batch-updating categories as part of a data migration or cleanup process.

Properties

Name Type Meaning
Category ID String The unique identifier of the category you want to update.
Additional Fields Collection Optional fields to update:
- Name (String): New name for the category.
- Description (String): New description for the category.

Output

  • The output will be a JSON object representing the updated category as returned by the Easy!Appointments API.
  • The structure typically includes fields such as id, name, description, and possibly other metadata depending on the API response.

Example output:

{
  "id": "5",
  "name": "Updated Category Name",
  "description": "New description for this category"
}

If the API returns additional fields, they will also be included in the output.

Dependencies

  • External Service: Requires access to an Easy!Appointments instance with API enabled.
  • Authentication: Needs credentials (easyAppointmentsApi) including:
    • Base URL
    • Username
    • Password
  • n8n Configuration: Credentials must be set up in n8n under the appropriate credential type.

Troubleshooting

Common issues:

  • Missing or incorrect Category ID: If the provided Category ID does not exist, the API may return a "Not Found" error.
  • Insufficient permissions: The user account used for authentication must have permission to update categories.
  • Invalid base URL: If the base URL is missing or incorrect, you may see errors like "Base URL is required."
  • Empty update payload: If no fields are provided in "Additional Fields," the request may succeed but not change anything.

Error messages:

  • "Base URL is required": Ensure the Easy!Appointments API URL is correctly set in your credentials.
  • "error": "..." in output: If continueOnFail is enabled, errors will appear in the output JSON under an error field. Review the message for hints (e.g., authentication failure, invalid ID).

Links and References

Discussion