BOSS API: to-dos, issues, priorities, scorecard and webhooks

The short version: the workspace owner makes an API key in BOSS under Settings, Connectors, API. Send it as Authorization: Bearer boss_... to https://app.bossforteams.com/api/v1. Keys are read only or read and write. The API is part of the Pro plan.

Getting started

In BOSS, open Settings, Connectors, and find API, Zapier and Power Automate.
Name the key, pick read only or read and write, and click Make a key. Copy it right away: it is shown only once.
Call GET /api/v1/me to check it works.

A key works for the whole workspace. It never returns private General meetings, people reviews or meeting talk that was held back as personal. Revoke a key at any time and it stops working at once, along with its webhooks.

Endpoints

Request	What it does
`GET /me`	The workspace name, the key name and whether it can write.
`GET /teams`	Teams, starting with Everyone.
`GET /people`	Active people with name, email, role and teams.
`GET /todos?status=open\|done\|all&team=&owner=email&limit=`	To-dos, newest first. Open by default.
`POST /todos`	Add a to-do: `title`, `owner_email`, optional `due_date` (YYYY-MM-DD, default a week out) and `team` (name, default Everyone).
`PATCH /todos/{id}`	Change `title`, `due_date` or `done`.
`GET /issues?status=open\|solved\|all&team=`	Issues, newest first.
`POST /issues`	Add an issue: `title`, optional `details`, `owner_email`, `team`.
`PATCH /issues/{id}`	Change `title`, `details` or `status` (open or solved).
`GET /priorities?quarter=2026-Q4`	Quarterly priorities with owner, team and status. This quarter by default.
`GET /measurables`	Scorecard numbers with goal, owner and the last 13 weeks of values.
`PUT /measurables/{id}/values/{date}`	Set a number for the week that contains `date`: body `{"value": 42}`. Numbers filled by a connector or formula cannot be set.
`GET /meetings?limit=20`	Finished meetings with rating, attendees, headlines and the recap.
`GET /hooks`	Webhooks made with this key.
`POST /hooks`	Subscribe: `event` and `url`. Returns the id and a signing secret.
`DELETE /hooks/{id}`	Unsubscribe.

Examples

List open to-dos

curl -H "Authorization: Bearer boss_YOUR_KEY" \
  https://app.bossforteams.com/api/v1/todos

Add a to-do

curl -X POST https://app.bossforteams.com/api/v1/todos \
  -H "Authorization: Bearer boss_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"title":"Call the bank","owner_email":"pat@company.com","due_date":"2026-11-07"}'

Set a scorecard number for this week

curl -X PUT https://app.bossforteams.com/api/v1/measurables/NUMBER_ID/values/2026-10-29 \
  -H "Authorization: Bearer boss_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"value": 48250}'

Webhooks

Subscribe to todo.created, todo.completed, issue.created or meeting.ended. BOSS posts JSON to your address:

{
  "event": "todo.created",
  "at": "2026-10-29T14:02:11.000Z",
  "data": { "id": "...", "title": "Call the bank", "owner": { "name": "Pat Lee", "email": "pat@company.com" },
            "team": "Everyone", "due_date": "2026-11-07", "done": false }
}

Each post carries X-Boss-Event and X-Boss-Signature: sha256=..., an HMAC-SHA256 of the raw body using the secret you got when subscribing. Answer with any 2xx code. Answer 410 to unsubscribe. A webhook that fails 50 times in a row is removed. Addresses must be public https addresses.

Zapier, Power Automate and Make

In Power Automate or Make, use an HTTP step with your key in the Authorization header, or a webhook trigger subscribed through POST /hooks. A BOSS app for Zapier with these triggers and actions is on the way.

Limits and errors

Up to 120 requests a minute per key, and up to 50 webhooks per workspace.
Errors come back as {"error": {"code": "...", "message": "..."}} with a 4xx status: 401 for a missing or revoked key, 403 for a read-only key trying to write, 404 for an unknown item, 429 when going too fast.
Lists return up to 500 items; use limit to ask for fewer.

AI apps

To use BOSS from Claude, ChatGPT or another AI app, you do not need a key. Add BOSS as a custom connector with the address https://app.bossforteams.com/mcp and sign in when asked. The app sees only what you can see in BOSS.

Questions

Does BOSS have an API?

Yes. BOSS has a REST API at https://app.bossforteams.com/api/v1 with workspace API keys, for to-dos, issues, priorities, scorecard numbers, meetings and people, plus webhooks. It is part of the Pro plan.

Can BOSS send webhooks?

Yes. Subscribe to todo.created, todo.completed, issue.created or meeting.ended and BOSS posts signed JSON to your https address.

Can I connect BOSS to Claude or ChatGPT?

Yes. Add a custom connector with the address https://app.bossforteams.com/mcp and sign in to BOSS. It sees only what you can see.

The BOSS API