Amesio
Riferimento API
POST/v1/eventsv2.4 · current

Crea evento

Crea un nuovo evento sul calendario dell'organizzazione autenticata. Restituisce l'evento creato con un id assegnato dal server.

OAuth 2.0 · Bearer token
events:writecalendar:read
Content-Typeapplication/json

Corpo della richiesta

Parametri
  • titlestringrequired

    Titolo dell'evento leggibile.

  • starts_atstringrequired

    Quando inizia l'evento.

  • ends_atstringrequired

    Deve essere successivo a starts_at.

  • visibilityenumrequired

    Visibilità dell'evento: public, private o invite_only.

    Allowed
    privategrouppublic
    Defaultprivate
  • locationobjectnullable

    Luogo dell'evento fisico o virtuale, facoltativo.

  • inviteesobject[]

    Fino a 100 invitati.

  • recurrenceobjectnullabledeprecated

    Regola di ricorrenza (RFC 5545).

Risposte

201CreatoEvento creato.
Campi della risposta
  • idstringrequired

    ID evento assegnato dal server.

  • created_atstring

    Timestamp di creazione ISO 8601.

  • …(all request body fields)

    Riproduce il corpo della richiesta, convalidato e normalizzato.

response.jsonjson
{
  "id": "evt_8x2k4ndp",
  "created_at": "2026-04-25T10:14:22Z",
  "title": "Q2 retro",
  "starts_at": "2026-04-28T14:00:00Z",
  "ends_at":   "2026-04-28T15:30:00Z",
  "visibility": "group"
}
400Richiesta non validaConvalida non riuscita.
401Non autorizzatoToken Bearer mancante o non valido.
404Non trovatoIl calendario non esiste.

Esempi

cURL

terminalbash
curl -X POST https://api.amesio.com/v1/events \
  -H "Authorization: Bearer $AMESIO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "title":      "Q2 retro",
    "starts_at":  "2026-04-28T14:00:00Z",
    "ends_at":    "2026-04-28T15:30:00Z",
    "visibility": "group"
  }'

TypeScript

src/create-event.tstypescript
const event = await amesio.events.create({
  title:      "Q2 retro",
  starts_at:  "2026-04-28T14:00:00Z",
  ends_at:    "2026-04-28T15:30:00Z",
  visibility: "group",
});

console.log(event.id);