ToolbenchDocs
Get a key

Start here

Quickstart

Issue a token and prove GET /me in about two minutes.

  1. 1

    Turn the API on

    Open Settings → API and enable it. Trial and Toolbench Core can both issue a token. Copy the tb_cus_ value the moment it appears — it is shown once.
    Shown once
    If you lose it, rotate. Rotating invalidates the old token instantly, including in ChatGPT and Claude.
  2. 2

    Keep it out of your code

    Put it in an environment variable, not a source file.
    shell
    export TB="https://app.toolbench.com/api/v1"
export TB_TOKEN="tb_cus_your_token_here"
  3. 3

    Make the one-line check

    GET /me is read-only and changes nothing. If it comes back with your identity and pulses, the token works.
    request
    curl -s "$TB/me" -H "Authorization: Bearer $TB_TOKEN"
  4. 4

    Read who hasn't texted back

    GET /inbox?filter=callbacks is missed-call texts with no reply.
    request
    curl -s "$TB/inbox?filter=callbacks" \
  -H "Authorization: Bearer $TB_TOKEN"
Your token

Held for this browser tab only. Closing the tab forgets it.

https://app.toolbench.com/api/v1/meNo token — send anyway to see 401
cURL
curl -X GET "https://app.toolbench.com/api/v1/me" \
  -H "Authorization: Bearer tb_cus_…"