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
Endpoints
get/partner
Who am I
Who am I
/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
name
string
token
object
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
mpt_test_…).
api_version
string
Errors
invalid_token: the token is missing, revoked or expired.
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"$client = new GuzzleHttp\Client();
$response = $client->request('GET', 'https://partners.monotree.com/api/v1/partner', [
'headers' => [
'Authorization' => 'Bearer '.getenv('MONOTREE_TOKEN'),
],
]);
$data = json_decode($response->getBody(), true);const response = await fetch('https://partners.monotree.com/api/v1/partner', {
method: 'GET',
headers: {
Authorization: `Bearer ${process.env.MONOTREE_TOKEN}`,
},
});
const data = await response.json();import os
import requests
response = requests.get(
"https://partners.monotree.com/api/v1/partner",
headers={
"Authorization": f"Bearer {os.environ['MONOTREE_TOKEN']}",
},
)
data = response.json(){
"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.