Calendar Entries

Simple date/time entries that appear in the employee calendar. Automatically published and added to the calendar on creation. The body is optional; entries can be global (no groups) or targeted.

Required scope: read:calendar_entries, write:calendar_entries.

Endpoints

GET
/api/open/v1/calendar-entries

List calendar entries (paginated)

GET
/api/open/v1/calendar-entries/{id}

Get a single calendar entry

POST
/api/open/v1/calendar-entries

Create a calendar entry

PUT
/api/open/v1/calendar-entries/{id}

Update a calendar entry

DELETE
/api/open/v1/calendar-entries/{id}

Delete a calendar entry (returns 204)

Create

curl -X POST https://customer.monotree.com/api/open/v1/calendar-entries \
  -H "Authorization: Bearer mono_your_token_here" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Company Holiday",
    "starts_at": "2026-06-01",
    "starts_time": "09:00",
    "ends_at": "2026-06-01",
    "ends_time": "17:00",
    "body": "Optional description",
    "groups": [1, 3]
  }'

Response

{
  "data": {
    "id": 101,
    "title": "Company Holiday",
    "body": null,
    "starts_at": "2026-06-01",
    "starts_time": "09:00",
    "ends_at": "2026-06-01",
    "ends_time": "17:00",
    "author": { "id": 1, "name": "John Doe", "email": "john@example.com" },
    "groups": [],
    "created_at": "2026-06-01T10:00:00+00:00",
    "updated_at": "2026-06-01T10:00:00+00:00"
  }
}