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 services within an appointment scheduling system. Specifically, the "Service - Create" operation allows users to create a new service by specifying its details such as name, duration, price, and additional optional attributes.

Common scenarios where this node is beneficial include:

  • Setting up new types of services offered by a business (e.g., haircut, massage, consultation).
  • Automating service creation workflows in appointment booking systems.
  • Integrating service management into broader automation pipelines for scheduling and customer management.

For example, a salon could use this node to automatically add a new "Hair Coloring" service with a specified duration and price whenever they update their offerings.

Properties

Name Meaning
Name The name of the service being created (e.g., "Haircut", "Consultation").
Duration (Minutes) Length of the service in minutes (e.g., 60).
Price Cost of the service (numeric value).
Additional Fields Optional extra details about the service:
- Currency The currency code for the price (default "USD").
- Location Physical location where the service is provided.
- Description Text description of the service.
- Availabilities Type Type of availability: "Flexible" or "Fixed".
- Attendants Number Number of attendants required for the service (default 1).
- Is Private Boolean indicating if the service is private (default false).
- Service Category ID Numeric ID representing the category this service belongs to.

Output

The node outputs JSON data representing the newly created service record returned from the Easy!Appointments API. This typically includes all the service's properties such as its unique ID, name, duration, price, and any additional fields set during creation.

No binary data output is involved.

Example output JSON structure (simplified):

{
  "id": 123,
  "name": "Haircut",
  "duration": 60,
  "price": 30,
  "currency": "USD",
  "location": "Main Salon",
  "description": "Basic haircut service",
  "availabilitiesType": "flexible",
  "attendantsNumber": 1,
  "isPrivate": false,
  "serviceCategoryId": 5
}

Dependencies

  • Requires an active connection to the Easy!Appointments API.
  • Needs an API authentication token configured in the node credentials.
  • The base URL of the Easy!Appointments instance must be set in the credentials.

Troubleshooting

  • Invalid settings JSON error: If providing JSON in additional fields (not typical for service creation but relevant for other resources), ensure the JSON syntax is correct.
  • API connection errors: Verify that the API base URL and authentication token are correctly configured.
  • Missing required fields: Ensure mandatory properties like "Name", "Duration (Minutes)", and "Price" are provided; otherwise, the API will reject the request.
  • Incorrect data types: Provide numeric values for duration, price, attendants number, and service category ID to avoid validation errors.

Links and References

Discussion