API reference

Partner

Your company, and the token you are calling with.

Base URL https://partners.monotree.com/api/v1 · every call needs a token

Who am I

get /partner

Your company (the partner), the token you are calling with and what it may do, and the version of the API. Needs no ability, so it is a good first call to check a token.

Response · 200 The partner and the token.

object

string

id

string

Your company's ID.

name

string

token

object

The token this call was made with.

id

string

name

string

abilities

array of strings

one of customers:read, customers:write, sellers:write, admins:write, security:read, webhooks:manage, tokens:manage, support:read, support:write, support:configure

sandbox

boolean

True for a sandbox token (mpt_test_…).

api_version

string

The version of the API. See the guide Versions and changelog.

Errors

401 invalid_token: the token is missing, revoked or expired.
429 rate_limited: too many requests. The general limit is 120 requests a minute for all your tokens of one mode (live or sandbox) together, and 300 a minute per IP address before the token is checked. Some calls have a lower limit of their own, which counts only calls that did what they ask (a call refused with another error uses up no place); the Rate limits guide lists them. Wait for the number of seconds in the Retry-After header.
curl https://partners.monotree.com/api/v1/partner \
  -H "Authorization: Bearer $MONOTREE_TOKEN"
200 · Response
{
    "object": "partner",
    "id": "prt_acme",
    "name": "Acme Scheduling",
    "token": {
        "id": "tok_7",
        "name": "Back office, production",
        "abilities": [
            "customers:read",
            "customers:write",
            "webhooks:manage"
        ],
        "sandbox": false
    },
    "api_version": "1.0.0"
}

Only mpt_test_… tokens work here; nothing reaches a real customer. Kept in this browser tab only.

Sending…