Quickstart

Create an API key and make your first request.

Get an API key

API keys are created in your account settings. You will see the key only once. Copy it and store it securely.

  1. Sign in to Twentybaan.
  2. Open Settings → Integrations.
  3. Click “Create API key” and copy the key.

Choose your client

The Twentybaan API is plain JSON over HTTPS. You can use any HTTP client. Below are lightweight defaults for common stacks.

Install

# cURL is most likely already installed on your machine
curl --version

First request

Call GET /v1/me/ to confirm authentication is working.

If you get an ok: true response, your API key is valid and you’re ready to integrate.

Request

GET
/v1/me/
curl -s \
  -H "Accept: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  https://api.twentybaan.com/v1/me/

Response

{
  "ok": true,
  "me": {
    "id": 123,
    "email": "you@example.com",
    "name": "Your Name",
    "is_admin": false,
    "is_lister": true,
    "plan": "standard"
  }
}

Next steps

tb twentybaan

Sign in to your account

Not a member? Create an account

Or continue with email

Uncheck on shared devices.