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 Secretary resource and the Delete operation, this node enables you to delete a secretary from your Easy!Appointments system by specifying their unique ID.

Common scenarios:

  • Removing a secretary who no longer works at your organization.
  • Cleaning up test or duplicate secretary records.
  • Automating user management workflows in your appointment scheduling system.

Practical example:
You might use this node in an automated workflow that removes secretaries based on HR triggers, or as part of a cleanup process after importing data.


Properties

Name Type Meaning
Secretary ID String The ID of the secretary to be deleted.

Output

The output will be a JSON object indicating the result of the deletion operation:

{
  "success": true
}

If the operation fails and "Continue On Fail" is enabled, the output will contain an error message:

{
  "error": "Error message here"
}

Dependencies

  • External Service: Requires access to an Easy!Appointments instance with API enabled.
  • API Credentials: You must configure the easyAppointmentsApi credential in n8n, which includes:
    • Base URL (without trailing slash)
    • Username
    • Password

Troubleshooting

Common issues:

  • Missing or incorrect Secretary ID: If the provided Secretary ID does not exist, the API may return an error.
  • Invalid credentials: If the API credentials are incorrect, authentication will fail.
  • Base URL not set: If the base URL is missing in the credentials, the node will throw a "Base URL is required" error.

Error messages and resolutions:

  • "Base URL is required": Ensure the Easy!Appointments API URL is correctly set in your credentials.
  • "Request failed with status code 404": The specified Secretary ID does not exist; verify the ID.
  • "Authentication failed": Check your username and password in the credentials.

Links and References

Discussion