heybmoDocsOpen HeyBMO

API reference

REST API

One endpoint shape for everything: send an operation's input, get its output. Operations are grouped by feature; you can call those of the features you have switched on.

Base URL https://app.heybmo.com

Calling an operation

Request
curl https://app.heybmo.com/api/ops/reminders.add \
  -H "Authorization: Bearer $HEYBMO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"input":{"reminders":[{"text":"Call mom","when":{"repeat":"never","date":"2026-11-09","time":"18:00"}}]}}'

The body is { "input": { … }, "spaceId"?: "…" }. A successful call answers 200 with { "output": { … } }; anything else is an error body.

Discovering operations

GET https://app.heybmo.com/api/ops/catalog lists every operation you can call right now, with its JSON Schemas and examples. It changes as you switch features on or off, and new fields are only ever added, never changed. The same catalog is published as OpenAPI.

Groups

Account7 operations

Your spaces, time zone, home currency and profile.

Inbox8 operations

Everything HeyBMO tells you, and your notification devices.

Today2 operations

The layout of the Today page and its widgets.

Feature store4 operations

The features you can switch on, and which ones are on.

Notes21 operations

Notes, folders, tags, files and search, including text inside pictures.

Lists25 operations

Lists with your own columns, items, ticking, due days and resets.

Expenses23 operations

Spending and income, categories, budgets, recurring bills and receipts.

Debts18 operations

People, money lent and borrowed, paybacks and balances.

Reminders14 operations

One-off and repeating reminders, snoozing, history and the agenda.

Automations6 operations

Rules that act when something happens in a feature.