n8n-nodes-easy-appointments

This package contains n8n nodes to interact with the Easy!Appointments API.

n8n is a fair-code licensed workflow automation platform.

Easy!Appointments is a highly customizable web application that allows customers to book appointments with you via a sophisticated web interface.

Installation

Follow the installation guide in the n8n community nodes documentation.

npm install n8n-nodes-easy-appointments

Nodes

Easy!Appointments

This node allows you to interact with the Easy!Appointments API. It provides access to all resources in a single node.

Resources:

• Appointment: Manage appointments
• Availability: Check provider availability
• Customer: Manage customer records
• Service: Manage service offerings

Operations:

• Appointment, Customer, Service:
  • Create
  • Delete
  • Get
  • Get All
  • Update
• Availability:
  • Get

Easy!Appointments Trigger

This trigger node allows you to listen for webhook events from Easy!Appointments.

Events:

• Appointment Created/Updated/Deleted
• Customer Created/Updated/Deleted
• Service Created/Updated/Deleted
• Provider Created/Updated/Deleted

The node automatically registers a webhook with Easy!Appointments when activated and removes it when deactivated.

Credentials

Easy!Appointments API

To use these nodes, you need to authenticate with the Easy!Appointments API. The following authentication methods are supported:

• Bearer Token: Generate an API key from the Easy!Appointments settings page.
• Basic Auth: Use the credentials of an admin user.

Resources

• n8n community nodes documentation
• Easy!Appointments API documentation

License

MIT

Local Development and Testing

To test this node package locally:

1. Build the package:

   pnpm build
   

2. Create a symbolic link to your n8n custom extensions directory:

   mkdir -p ~/.n8n/custom
   ln -s "$(pwd)" ~/.n8n/custom/n8n-nodes-easy-appointments
   

3. Start n8n with custom extensions:

   export N8N_CUSTOM_EXTENSIONS=~/.n8n/custom
   n8n start
   

   Alternatively, use the provided script:

   ./start-n8n-with-custom-nodes.sh
   

4. Open n8n in your browser (usually at http://localhost:5678)

5. Create a new workflow and search for "Easy!Appointments" in the nodes panel

6. Set up the Easy!Appointments API credentials and start using the nodes

When you make changes to the code:

1. Rebuild the package:

   pnpm build
   

2. Restart n8n to load the updated nodes