ToolbenchDocs
Get a key

API

Recipes

Text a contact, list callbacks, draft a review reply.

Prove the token

GET /me is read-only and returns identity plus pulses.

  1. Copy a tb_cus_ token from Settings → API.
  2. GET /me with Authorization: Bearer.
  3. You should see identity.email and inbox_pulse, not a capabilities object.

Who hasn't texted back

GET /inbox?filter=callbacks is missed-call texts with no reply.

  1. GET /inbox?filter=callbacks.
  2. Each item has contact_id, phone, and age_minutes.
  3. filter=open is the live inbox. callbacks is we-texted-they-never-replied.

Text a contact

POST /contacts/{id}/messages sends as soon as the key is write-mode.

  1. GET /contacts?q= to find the id.
  2. Turn write on for the token.
  3. POST /contacts/{id}/messages with { body } and an Idempotency-Key header.

Draft a review reply

POST /reviews/{id}/draft writes a reply. It does not publish it.

  1. GET /reviews and pick an unreplied id.
  2. POST /reviews/{id}/draft — this drafts.
  3. Approve or decline later with POST /actions/{id}/decide.
text a contact
curl -X POST "$TB/contacts/ct_01/messages" \
  -H "Authorization: Bearer $TB_TOKEN" \
  -H "Idempotency-Key: job-8841" \
  -H "Content-Type: application/json" \
  -d '{:}'