Convo API Docs

Get your API key

API keys can only be created from the Convo desktop app, available for macOS and Windows.

Open the app → Settings → API Keys → Create New Key. Copy the key — it's only shown once.

Make your first request

curl -H "Authorization: Bearer convo_your_key_here" \
  https://www.itsconvo.com/api/v1/user/profile

const res = await fetch("https://www.itsconvo.com/api/v1/user/profile", {
  headers: { Authorization: "Bearer convo_your_key_here" },
});
const { data } = await res.json();
console.log(data.subscription.tier);

import requests

resp = requests.get("https://www.itsconvo.com/api/v1/user/profile",
    headers={"Authorization": "Bearer convo_your_api_key_here"})
data = resp.json()["data"]

See the response

{
  "data": {
    "profile": { "name": "Alice Chen", "email": "alice@example.com" },
    "subscription": { "tier": "professional", "status": "active" },
    "apiUsage": { "aiGenerations": { "used": 12, "limit": 100, "remaining": 88 } }
  }
}