OverviewProductsPlatformsAPI ReferenceResources
Calendar

Create an event

POSThttps://zernio.com/api/v1/calendar/events

Creates a calendar event. Conferencing and recurrence behave differently on Microsoft and Google accounts.

Authentication

AuthorizationBearer tokenRequired

API key authentication: send your Zernio API key in the Authorization header, prefixed with Bearer.

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Responses

Success· the request worked

Errors· the request failed

How it behaves

Microsoft accounts

  • conferencing: teams adds a Teams meeting. The created event comes back with conferencing: null when the tenant has no Teams (the EEA Business Basic SKUs ship without it).
  • google_meet is rejected with 400 (param: conferencing).

Google accounts

  • conferencing: google_meet adds a Meet link.
  • teams is rejected with 400.
  • recurrence accepts any RRULE Google Calendar supports.

Recurrence

recurrence takes one RRULE line with FREQ, INTERVAL, COUNT, UNTIL, BYDAY and BYSETPOS. Other parts are rejected with 400 (param: recurrence).

Reminders

Each reminders.overrides entry is { method, minutes }, with method popup (default) or email.

  • Google takes up to 5 overrides of either method.
  • Outlook keeps one popup reminder, the first override. An email override answers 400 reminder_method_unsupported.
POST/v1/calendar/events
import Zernio from '@zernio/node';const zernio = new Zernio({ apiKey: process.env.ZERNIO_API_KEY });const { data } = await zernio.calendar.createCalendarEvent({  body: {    accountId: '66b2e19d8c3f5a7e9d0b1c2d',    title: 'Contract review',    start: '2026-11-18T16:00:00+01:00',    end: '2026-11-18T17:00:00+01:00',    reminders: {      useDefault: false,      overrides: [        {          method: 'email',          minutes: 1440,        },        {          method: 'popup',          minutes: 10,        },      ],    },  },});console.log(data);
{  "data": {    "id": "string",    "accountId": "string",    "provider": "google",    "calendarId": "string",    "title": "string",    "description": "string",    "location": "string",    "start": "string",    "end": "string",    "allDay": true,    "timezone": "string",    "participants": [      {        "email": "user@example.com",        "name": "string",        "status": "accepted",        "comment": "string",        "optional": true,        "resource": true,        "self": true,        "organizer": true      }    ],    "organizer": {      "email": "user@example.com",      "name": "string"    },    "recurrence": [      "string"    ],    "reminders": {      "useDefault": true,      "overrides": [        {          "method": "popup",          "minutes": 0        }      ]    },    "conferencing": {      "provider": "google_meet",      "url": "http://example.com"    },    "busy": true,    "visibility": "default",    "status": "confirmed",    "icalUid": "string",    "masterEventId": "string",    "type": "single",    "originalStart": "string",    "htmlLink": "string",    "readOnly": true,    "metadata": {      "property1": "string",      "property2": "string"    },    "createdAt": "2019-08-24T14:15:22Z",    "updatedAt": "2019-08-24T14:15:22Z"  }}
OpenAPI specification
Was this page helpful?