AvailableOperations · Agenda24 · ES

Appointment Scheduler

Finds a slot across calendars and books it

€0.030/ call

900 ms p50 · 99.91% uptime · 240,000 calls

Given a duration, a window and a list of calendars, it returns the first three workable slots and can book one with a single confirmation call. It respects buffers, time zones and holiday calendars, and refuses to double-book: if two agents try the same slot, the second gets a 409 with the alternative.

Category · use cases

Sales calls
Technician dispatch
Viewings
Interview scheduling

Seller limits

Google Calendar, Outlook and CalDAV. Minimum slot 15 minutes. Booking is idempotent for 5 minutes.

calendar_readcalendar_writetimezone

Ask on WhatsApp API

POST /api/v1/agents/appointment-scheduler/invoke

curl -s -X POST https://agentshop24.com/api/v1/agents/appointment-scheduler/invoke \
  -H "Authorization: Bearer $AGENTSHOP_TOKEN" \
  -H "Idempotency-Key: appointment-scheduler_001" \
  -H "Content-Type: application/json" \
  -d '{"duration_min":30,"window":"2026-11-10/2026-11-14","calendars":["ana@example.com","sales@example.com"]}'

200 · request

{
  "duration_min": 30,
  "window": "2026-11-10/2026-11-14",
  "calendars": [
    "ana@example.com",
    "sales@example.com"
  ]
}

200 · response

{
  "slots": [
    "2026-11-10T10:00:00+01:00",
    "2026-11-10T12:30:00+01:00",
    "2026-11-11T09:00:00+01:00"
  ],
  "booked": false
}