agendapro

n8n community node for AgendaPro: bookings, available slots, clients, locations, services and providers, plus a signed webhook trigger.

Package Information

Released: this month
Downloads: 0 weekly / 0 monthly
Latest Version: 0.1.0
Author: ricardonldev

Documentation

n8n-nodes-agendapro

n8n community node for AgendaPro (appointments for clinics, salons and spas), through the official AgendaPro API v3.

Operations

AgendaPro node

Resource Operations
Booking Create, Get, Get Many (filter by client, location, service, provider, status, dates), Update (reschedule or change), Cancel
Available Slot Get free slots for a day at a location (optionally for a service or provider)
Client Create, Get, Get Many, Search (name, email, phone or ID number), Update
Location, Service, Provider Get Many

Locations, services and providers can be picked from a list. The node can also be used as a tool by AI agents, for example a booking assistant on WhatsApp.

AgendaPro Trigger (webhook): booking created or updated, client created or updated, payment request paid or expired, service updated. Each call is verified with the webhook secret (HMAC-SHA256 signature and timestamp, as described in the AgendaPro docs).

Credentials

  1. In AgendaPro, open Settings > Integrations and create an API key (it is shown only once).
  2. In n8n, create an AgendaPro API credential with that key.

Trigger setup

  1. Add the AgendaPro Trigger to a workflow and copy its Production URL.
  2. In AgendaPro, open Settings > Integrations > Webhooks, create a webhook with that URL and choose the events.
  3. Paste the secret AgendaPro shows (whsec_...) into the trigger, choose the same events and activate the workflow.

Compatibility

Tested against a mock that checks every request against the official AgendaPro OpenAPI definitions (paths, query parameters, required fields, types), in unit tests and inside n8n 2.40.7. The trigger was tested in a running n8n 2.40.7 with signed calls. Not yet tested against a live AgendaPro account.

Development

npm install
npm run build
node scripts/fetch-spec.mjs   # downloads the official API definitions used by the tests
npm test

License

MIT

Discussion