The spec is generated from the code.
CI makes sure it stays true.

curl -X POST https://api.softknack.com/crm/v1/leads \
  -H "Authorization: Bearer sk_test_..." \
  -H "Idempotency-Key: 9f2c-...-d41a" \
  -H "Content-Type: application/json" \
  -d '{
    "contact": { "name": "Priya Raghavan", "phone": "+91XXXXXXXXXX" },
    "source": "website",
    "interests": [{ "catalog_item_id": "itm_01J9X...", "note": "1.5T split AC" }]
  }'

# → 201 · { "id": "ld_01J9X...", "contact_id": "ctc_01J9X...", "stage": "new" }

import { verifySignature } from "@softknack/webhooks";

app.post("/hooks/crm", (req, res) => {
  if (!verifySignature(req, process.env.SK_WEBHOOK_SECRET)) return res.status(401).end();
  const ev = req.body;          // dedupe on ev.id — at-least-once delivery
  if (ev.event === "lead.stage_changed" && ev.to === "won") celebrate(ev);
  res.status(200).end();      // ack fast; process async
});

import requests

r = requests.post(
    "https://api.softknack.com/crm/v1/contacts/ctc_01J9X.../context",
    headers={"Authorization": "Bearer sk_test_..."},
)
bundle = r.json()
# → carried-forward fields, recent activities, open items —
#   the same bundle SK Voice reads before saying hello
print(bundle["fields"]["preferred_time"])  # "evenings"