Start in four steps

1. Get a key. The owner of the Spotbookr account signs in and opens Account, Integrations, names the key, chooses what it may do, and copies it. It is shown once.
2. Check it works. Call GET https://work.spotbookr.com/api/v1/ping with the header Authorization: Bearer YOUR_KEY. The answer names the company and says what the key may do.
3. Read something. GET /api/v1/contacts lists contacts. Every list has the same shape: data, total, limit, offset.
4. Change something. POST adds a record and answers 201 with it; PATCH changes only the fields you send; DELETE removes it where that is allowed.

Command line

curl https://work.spotbookr.com/api/v1/ping -H "Authorization: Bearer YOUR_KEY"

curl -X POST https://work.spotbookr.com/api/v1/contacts \
  -H "Authorization: Bearer YOUR_KEY" -H "Content-Type: application/json" \
  -d '{"name": "Dana Reyes", "email": "dana@example.com", "company": "Example Co", "tags": ["newsletter"]}'

curl -X PATCH https://work.spotbookr.com/api/v1/tasks/123 \
  -H "Authorization: Bearer YOUR_KEY" -H "Content-Type: application/json" -d '{"done": true}'

Python

import requests

api = "https://work.spotbookr.com/api/v1"
headers = {"Authorization": "Bearer YOUR_KEY"}

# every contact, a page at a time
offset = 0
while True:
    page = requests.get(api + "/contacts", headers=headers, params={"limit": 200, "offset": offset}).json()
    for contact in page["data"]:
        print(contact["name"], contact["email"])
    offset += page["limit"]
    if offset >= page["total"]:
        break

# open a deal for a contact
r = requests.post(api + "/deals", headers=headers, json={"name": "Website rebuild", "contact_id": 42, "value": 4800})
if r.status_code != 201:
    print(r.json()["error"]["message"])

JavaScript (on a server, not in a browser)

const api = "https://work.spotbookr.com/api/v1";
const headers = { Authorization: "Bearer " + process.env.SPOTBOOKR_KEY, "Content-Type": "application/json" };

const res = await fetch(api + "/tasks", {
  method: "POST", headers,
  body: JSON.stringify({ title: "Call back about pricing", due: "2026-11-03", contact_id: 42 }),
});
const body = await res.json();
if (!res.ok) throw new Error(body.error.message);
console.log(body.data.id);

To hear the moment something happens, such as a deal being won or an invoice being paid, use webhooks: Spotbookr sends a signed message to an address of yours. They are set up under Account, Integrations, and work alongside the API.