torcom

n8n nodes for Torcom: book appointments, manage customers, find free slots, and trigger workflows on new appointments, customers and payments.

Package Information

Released: this month
Downloads: 0 weekly / 0 monthly
Latest Version: 0.1.1
Author: Torcom

Documentation

n8n-nodes-torcom

This is an n8n community node package for Torcom, an appointment and calendar app for service businesses (barbershops, nail salons, beauty professionals).

It lets your n8n workflows book and change appointments, keep customer cards up to date, find free time, and start when appointments, customers or payments change.

n8n is a fair-code licensed workflow automation platform.

Installation

Follow the installation guide in the n8n community nodes documentation. In n8n, open Settings › Community Nodes › Install and enter n8n-nodes-torcom.

Credentials

The nodes use a Torcom API key.

  1. Sign in to Torcom as the business owner and open Settings › API. The public API is part of the plans that include it.
  2. Create a key and tick the operations it may call. Copy it: it is shown once.
  3. In n8n, create a Torcom API credential and paste the key into API Key. Leave Base URL at its default (https://api.torcom.co.il/public/v1).

n8n checks the credential by calling GET /me. A key can call only the operations ticked for it; any other call answers "scope denied".

The same credential works in n8n's HTTP Request node (Authentication › Predefined Credential Type › Torcom API) for any other endpoint of the Torcom API.

Operations

Appointment

  • Get: an appointment by ID.
  • Create: book a service with a staff member at a start time, for an existing customer (picked from the list or by ID) or a new one (name and phone; an existing customer with that phone is reused). Optional notes and idempotency key. The customer gets Torcom's usual confirmation message. A time that is no longer free fails with "slot taken".
  • Reschedule: move an appointment to a new start time, and optionally to another staff member or with a new note.
  • Cancel: cancel an appointment, with an optional reason sent to the customer under the cancellation message.

Customer

  • Create: add a customer card (name, phone, and optionally email, notes, tags, birth date, marketing consent). The phone must be new to the business.
  • Update: change any field of a customer card.
  • Search: find customers by part of a name or at least three digits of a phone, one item per customer.
  • Add Note: add a note to a customer's card, optionally pinned to the top.

Availability

  • Find Free Slots: free start times for a service, with one staff member or any, over a date range of up to 62 days. Returns one item per slot (date, start, staff_id).

Services, staff members and customers can be picked from a searchable list or given by ID.

Trigger events

The Torcom Trigger node polls Torcom on the schedule you set.

  • New Appointment: an appointment was booked.
  • Updated Appointment: an appointment was booked or changed (rescheduled, cancelled, notes or status). Recording a payment does not count as a change; use New Payment.
  • New Customer: a customer card was added.
  • New Payment: a payment was recorded for a visit.

When the workflow is activated, the trigger starts from that moment and emits each item once, in the order it happened. A change shows up about five seconds after it was made. A manual test (Fetch Test Event) returns the latest few items, so you can map their fields.

Usage notes

  • Times are ISO 8601. Torcom answers in UTC. A start time typed without an offset is read in the workflow's timezone (Workflow Settings › Timezone); set it to your business timezone (usually Asia/Jerusalem), or pass a time with an offset such as 2026-11-03T09:30:00+02:00.
  • Dates (availability, birth dates) are calendar dates in the business timezone, YYYY-MM-DD.
  • Phones are stored in E.164 (+972501234567); local Israeli numbers (050-1234567) are accepted on input.
  • Money is ILS, as a string with two decimals ("120.00").
  • Errors show Torcom's message (for example "Not found" or "Slot taken") with its details and error code.

Compatibility

Built with @n8n/node-cli 0.54 and tested on n8n 2.45.

Resources

Support

Email info@torcom.co.il.

License

MIT

Discussion