Mercateer icon

Mercateer

AI front-office for trades and home-services: calls, quotes, appointments, omnichannel inbox

Actions26

Appointment → Book

AI-generated

Summary

Books an appointment for a Mercateer organization, passing a stable idempotency key and any supplied scheduling or association details. The API performs the booking with a conflict check.

Inputs

  • Organization ID (required) — Mercateer organization ID.
  • Idempotency Key (required) — Unique key for safe retries; reuse a stable value so retries do not double-book.
  • Scheduled Start — Appointment start time as epoch milliseconds. A value of 0 is omitted from the request.
  • Job Type — Service or job type.
  • Address — Service address.
  • Contact ID — Contact to associate with the appointment.
  • Conversation ID — Conversation to associate with the appointment.
  • Agent ID — Agent to attribute the appointment to.

Output shape

A single appointment record as an n8n JSON output item.

The operation sends a POST request to the appointment booking endpoint. Optional blank values are omitted; array or items-list results, if returned, are split into one output item per row. API errors are surfaced as node errors, or as error output items when Continue On Fail is enabled.

Links

Discussion