Amesio
Référence de l'API
POST/v1/eventsv2.4 · current

Créer un événement

Crée un nouvel événement sur le calendrier de l'organisation authentifiée. Renvoie l'événement créé avec un id attribué par le serveur.

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

Corps de la requête

Paramètres
  • titlestringrequired

    Titre lisible de l'événement.

  • starts_atstringrequired

    Quand l'événement commence.

  • ends_atstringrequired

    Doit être postérieur à starts_at.

  • visibilityenumrequired

    Visibilité de l'événement : public, private ou invite_only.

    Allowed
    privategrouppublic
    Defaultprivate
  • locationobjectnullable

    Lieu physique ou virtuel facultatif de l'événement.

  • inviteesobject[]

    Jusqu'à 100 invités.

  • recurrenceobjectnullabledeprecated

    Règle de récurrence (RFC 5545).

Réponses

201CrééÉvénement créé.
Champs de réponse
  • idstringrequired

    ID d'événement attribué par le serveur.

  • created_atstring

    Horodatage de création ISO 8601.

  • …(all request body fields)

    Reproduit le corps de la requête, validé et normalisé.

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"
}
400Requête incorrecteLa validation a échoué.
401Non autoriséJeton Bearer manquant ou invalide.
404IntrouvableLe calendrier n'existe pas.

Exemples

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);