Skip to main content
All API requests require a Bearer token in the Authorization header. See the Quick Start to create your key and make your first request. 
Authorization: Bearer convo_your_api_key_here

​
Code Examples

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

​
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

StatusCodeWhen
401unauthorizedMissing or malformed Authorization header
403forbiddenValid key on the Free plan — API access requires Starter or above