Skip to main content
1

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.
2

Make your first request

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

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 } }
  }
}
That’s it. Replace /user/profile with any endpoint in the API Reference tab. Rate limit headers (X-RateLimit-Remaining) are included in every response.