Quickstart - Hobbes Customer Hub

Create a scoped API key

In Hobbes, open Settings → Organization → API keys. Create a key with the Sessions scope. Only organization admins can create or revoke keys.Copy the token when it appears. Hobbes shows the plaintext token once and stores only its hash.

Store the token

Keep the token in a secret manager or environment variable. Never commit it to source control or expose it in browser code.

export HOBBES_API_KEY="hb_live_..."

Retrieve qualified sessions

Request the ten most recent sessions whose latest qualification result is qualified.

curl --fail-with-body \
  --get "https://api-us.hihobbes.com/api/v1/sessions" \
  --data-urlencode "qualification_status=qualified" \
  --data-urlencode "limit=10" \
  --header "Authorization: Bearer $HOBBES_API_KEY"

import os
import requests

response = requests.get(
    "https://api-us.hihobbes.com/api/v1/sessions",
    headers={"Authorization": f"Bearer {os.environ['HOBBES_API_KEY']}"},
    params={"qualification_status": "qualified", "limit": 10},
    timeout=30,
)
response.raise_for_status()

payload = response.json()
for session in payload["sessions"]:
    print(session["id"], session["email"], session["buyingIntent"])

const url = new URL("https://api-us.hihobbes.com/api/v1/sessions");
url.searchParams.set("qualification_status", "qualified");
url.searchParams.set("limit", "10");

const response = await fetch(url, {
  headers: { Authorization: `Bearer ${process.env.HOBBES_API_KEY}` },
});
if (!response.ok) {
  throw new Error(`Hobbes API ${response.status}: ${await response.text()}`);
}

const payload = await response.json();
for (const session of payload.sessions) {
  console.log(session.id, session.email, session.buyingIntent);
}

Follow pagination

List responses include the current limit, offset, and total matching records. Request the next page while offset + limit < total.

{
  "pagination": {
    "total": 248,
    "limit": 10,
    "offset": 0
  }
}

Save the X-Request-ID response header in integration logs. It identifies the exact request if you need help diagnosing a failure.

Next steps

Authentication and scopes

Create narrowly scoped keys and rotate them safely.

Pagination and filtering

Build complete and restartable data synchronization jobs.

⌘I

​Next steps

Authentication and scopes

Pagination and filtering

Next steps