Eventi Calendario

Crea ed elenca gli eventi di appuntamento gestiti attraverso i tuoi calendari.

Elencare gli eventi

GET /v1/calendar/events

Recupera una lista paginata di appuntamenti della tua organizzazione.

Scope richiesto: calendar:read

Parametri di query

Parametro	Tipo	Descrizione
page	integer	Numero pagina (default: 1)
limit	integer	Risultati per pagina (default: 20, max: 100)
calendarId	string	Filtra per ID calendario
eventTypeId	string	Filtra per ID tipo evento
status	string	Filtra per stato (es. confirmed, cancelled)
dateFrom	string	ISO 8601 — solo eventi dopo questa data
dateTo	string	ISO 8601 — solo eventi prima di questa data

Esempio

curl "https://api.replicer.ai/v1/calendar/events?status=confirmed&limit=10" \
  -H "Authorization: Bearer rpl_live_your_key"

Risposta 200 OK

{
  "data": [
    {
      "id": "clx-event-001",
      "calendarId": "clx-cal-001",
      "eventTypeId": "clx-et-001",
      "startTime": "2026-04-10T09:00:00Z",
      "endTime": "2026-04-10T09:30:00Z",
      "timezone": "Europe/Rome",
      "customerName": "Mario Rossi",
      "customerPhone": "+1234567890",
      "customerEmail": "[email protected]",
      "notes": "Consulenza iniziale",
      "title": "Demo Prodotto",
      "location": "Zoom",
      "status": "confirmed",
      "bookedVia": "api",
      "createdAt": "2026-04-05T10:00:00Z",
      "updatedAt": "2026-04-05T10:00:00Z"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 10,
    "total": 25,
    "totalPages": 3
  },
  "requestId": "req-abc123"
}

---

Creare un evento

POST /v1/calendar/events

Crea un nuovo evento di appuntamento.

Scope richiesto: calendar:write

Body della richiesta

Campo	Tipo	Obbligatorio	Descrizione
calendarId	string	Sì	ID del calendario
eventTypeId	string	Sì	ID del tipo di evento
startTime	string	Sì	Orario di inizio ISO 8601
endTime	string	Sì	Orario di fine ISO 8601
timezone	string	No	Timezone IANA (default: UTC)
customerName	string	No	Nome del cliente
customerPhone	string	No	Numero di telefono
customerEmail	string	No	Indirizzo email
title	string	No	Titolo dell'evento
location	string	No	Luogo o link della riunione
notes	string	No	Note aggiuntive

Esempio

curl -X POST https://api.replicer.ai/v1/calendar/events \
  -H "Authorization: Bearer rpl_live_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "calendarId": "clx-cal-001",
    "eventTypeId": "clx-et-001",
    "startTime": "2026-04-15T14:00:00Z",
    "endTime": "2026-04-15T14:30:00Z",
    "timezone": "Europe/Rome",
    "customerName": "Laura Bianchi",
    "customerEmail": "[email protected]",
    "title": "Demo Prodotto"
  }'

Risposta 201 Created

{
  "data": {
    "id": "clx-event-002",
    "calendarId": "clx-cal-001",
    "eventTypeId": "clx-et-001",
    "startTime": "2026-04-15T14:00:00Z",
    "endTime": "2026-04-15T14:30:00Z",
    "timezone": "Europe/Rome",
    "customerName": "Laura Bianchi",
    "customerPhone": null,
    "customerEmail": "[email protected]",
    "notes": null,
    "title": "Demo Prodotto",
    "location": null,
    "status": "confirmed",
    "bookedVia": "api",
    "createdAt": "2026-04-05T10:00:00Z"
  },
  "requestId": "req-def456"
}

Errori

Codice	Causa
validation_error	calendarId, eventTypeId, startTime o endTime mancanti
not_found	Il calendario o tipo evento non esiste o non appartiene alla tua org