Monotree Open API

The Open API lets external systems work with your Monotree platform. Read and create posts, announcements and courses, browse users and groups, push alerts into chat rooms or walls with incoming webhooks, react to events with outgoing webhooks, and build two-way integrations with HR systems, automation tools or your own backend. AI assistants connect through the MCP server instead.

New to MCP, API and webhooks? See the overview on monotree.com

LLM-friendly docs

The full reference is available as a single plain-text file. Paste it into Claude, ChatGPT or any model before asking it to write integration code.

View llms.txt

Versioning

The API is currently at v1. Breaking changes will result in a new version (e.g. v2); additive changes (new fields, new endpoints) ship within v1.

Base URL

https://customer.monotree.com/api/open/v1

Replace customer with your company's Monotree subdomain. All examples in these docs use the placeholder.

Timestamps

Timestamps are ISO 8601 in Copenhagen time with its offset and no fractions, such as 2026-05-20T09:30:00+02:00 (+01:00 in winter), and dates are YYYY-MM-DD, unless a field says otherwise: last_active_on on the user object and checked_at in outgoing reports are UTC with microseconds (2026-05-20T07:30:00.000000Z), the Manager Hub's next_shift_at has no offset, and webhook envelopes carry a Unix timestamp.

Quick start

Admins create API tokens in the Monotree CMS under Open API → API Tokens. Pick the scopes the integration needs, copy the token (it is shown once), then make your first request:

curl https://customer.monotree.com/api/open/v1/walls \
  -H "Authorization: Bearer mono_your_token_here" \
  -H "Accept: application/json"

Send Accept: application/json on every request, so errors come back as JSON (see Errors), and Content-Type: application/json on requests with a JSON body. To check a new token's scopes, call GET /token.

What's covered

Authentication — API tokens, scopes, IP restrictions and feature-gated endpoints.
Content — Walls, Posts, Comments, Media, Articles, Handbooks, Courses, Surveys, Forms, Announcements, Staff Cards, Events, Calendar Entries, Calendar Event Types, Certificates, Certificate Types, Journeys, Achievements.
People and messaging — Users, Groups, Org Chart, Bots, Direct Messages, Scheduled Messages, Notifications.
Platform — Locales, Statistics, Academy Statistics, Manager Hub, Feedback.
Webhooks — Incoming, Outgoing, Outgoing Reports, and managing incoming and outgoing webhooks over the API.
Reference — HTTP status codes, Pagination, Rate limiting, Errors, Changelog.

Feedback

Feature requests, bug reports or anything that felt awkward to build against: send it via POST /feedback with a single body string. It lands directly with the developers building the API. See Feedback.