Easy!Appointments icon

Easy!Appointments

Interact with Easy!Appointments API
Join our community

Actions21

Overview

This node integrates with the Easy!Appointments API to manage customer records. Specifically, the "Get" operation for the "Customer" resource retrieves detailed information about a single customer by their unique ID. This is useful in scenarios where you need to fetch customer details for further processing, reporting, or integration with other systems.

Practical examples include:

  • Retrieving customer contact information before sending notifications.
  • Fetching customer data to display in a CRM dashboard.
  • Using customer details to personalize appointment reminders.

Properties

Name Meaning
Customer ID The unique identifier of the customer to retrieve. This is a required string input.

Output

The output is a JSON object representing the customer's data as returned by the Easy!Appointments API. It typically includes fields such as first name, last name, email, phone number, address, city, ZIP code, timezone, language, notes, and custom fields if set.

If multiple customers were retrieved (not applicable here since this is a single get), the output would be an array of such objects. For this "Get" operation, the output is a single JSON object inside the json field.

No binary data output is produced by this operation.

Dependencies

  • Requires an active connection to the Easy!Appointments API.
  • Needs an API authentication credential configured in n8n to authorize requests.
  • The base URL for the Easy!Appointments instance must be set in the credentials.

Troubleshooting

  • Common issues:

    • Invalid or missing Customer ID will cause the API request to fail.
    • Network connectivity problems or incorrect base URL configuration can prevent successful API calls.
    • Insufficient permissions or invalid API credentials will result in authorization errors.

  • Error messages:

    • Errors from the API are caught and returned as error messages in the output if "Continue On Fail" is enabled.
    • If the Customer ID does not exist, the API may return a "Not Found" error.
    • JSON parsing errors are unlikely here since this operation only fetches data.

To resolve errors:

  • Verify the Customer ID is correct and exists in Easy!Appointments.
  • Check that the API credentials and base URL are properly configured.
  • Ensure network access to the Easy!Appointments server.

Links and References

Discussion