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 "Customer - Create" operation allows users to add new customers to their Easy!Appointments system by providing personal and contact details along with optional additional information.

Common scenarios where this node is beneficial include:

  • Automating customer onboarding workflows by creating customer profiles when a new lead is captured.
  • Synchronizing customer data from other systems or forms into Easy!Appointments.
  • Bulk importing customer data into Easy!Appointments via n8n workflows.

For example, you could use this node to create a new customer record with their first name, last name, email, phone number, and optionally address and notes, enabling appointment scheduling and communication within Easy!Appointments.

Properties

Name Meaning
First Name The first name of the customer.
Last Name The last name of the customer.
Email The email address of the customer.
Phone The phone number of the customer (may be required depending on your Easy!Appointments settings).
Additional Fields Optional extra fields for the customer including:
- Address The address of the customer.
- City The city of the customer.
- ZIP The ZIP code of the customer.
- Timezone The timezone of the customer (default is "UTC").
- Language The language of the customer (default is "english").
- Notes Notes about the customer.
- Custom Field 1 Custom field 1 value.
- Custom Field 2 Custom field 2 value.
- Custom Field 3 Custom field 3 value.
- Custom Field 4 Custom field 4 value.
- Custom Field 5 Custom field 5 value.

Output

The output JSON contains the response from the Easy!Appointments API after creating the customer. This typically includes the newly created customer's details such as their unique ID and all submitted fields.

The node does not output binary data.

Example output structure (simplified):

{
  "id": 123,
  "firstName": "John",
  "lastName": "Doe",
  "email": "john.doe@example.com",
  "phone": "+1234567890",
  "address": "123 Main St",
  "city": "Anytown",
  "zip": "12345",
  "timezone": "UTC",
  "language": "english",
  "notes": "Preferred customer",
  "customField1": "Value1",
  ...
}

Dependencies

  • Requires an active Easy!Appointments API endpoint accessible via a base URL configured in the node credentials.
  • Requires an API authentication token or key configured in the node's credentials to authorize requests.
  • The node uses standard HTTP methods (POST) to communicate with the Easy!Appointments REST API.

Troubleshooting

  • Invalid or missing API credentials: Ensure that the API key/token and base URL are correctly set in the node credentials.
  • Required fields missing: The node expects at least the basic customer fields (e.g., first name, last name, email). Missing mandatory fields may cause API errors.
  • Phone number requirement: Depending on your Easy!Appointments settings, the phone number might be required. If omitted, the API may reject the request.
  • API errors: If the API returns an error, the node will throw it unless "Continue On Fail" is enabled, in which case the error message will be included in the output JSON under error.
  • Invalid additional fields: Custom fields must be strings; ensure correct data types to avoid validation errors.

Links and References

Discussion