Authentication
All API requests require a Bearer token in the Authorization header.
All API requests require a Bearer token in the Authorization header. API access requires a Starter plan or above — see Tier Access for details. See the Quick Start to create your key and make your first request.
Authorization: Bearer convo_your_api_key_hereCode Examples
curl -H "Authorization: Bearer convo_your_key_here" \
https://www.itsconvo.com/api/v1/conversationsimport requests
resp = requests.get("https://www.itsconvo.com/api/v1/conversations",
headers={"Authorization": "Bearer convo_your_api_key_here"})
data = resp.json()["data"]const res = await fetch("https://www.itsconvo.com/api/v1/conversations", {
headers: { Authorization: "Bearer convo_your_key_here" },
});
const { data } = await res.json();Key Security
- Keys are hashed on our servers — they cannot be retrieved after creation
- Store keys in environment variables, never in source code
- If a key is compromised, revoke it in Settings → API Keys and create a new one
Error Responses
| Status | Code | When |
|---|---|---|
401 | unauthorized | Missing or malformed Authorization header |
403 | forbidden | Valid key on the Free plan — API access requires Starter or above |