Skip to main content
All requests to the Conversion API must include a valid API key. API keys are scoped to a single business and grant full access to that business’s data.

​
API key format

API keys follow this format: 
sk_live_<key_id>_<secret>
You can generate and manage API keys from the Settings > API Keys page in the Conversion dashboard.
Treat your API key like a password. Do not expose it in client-side code, public repositories, or browser requests. Always make API calls from a secure server environment.

​
Authenticating requests

Include your API key in the X-API-Key header of every request. 
curl -X POST https://pub-api.conversion.ai/api/v2/contacts \
  -H "Content-Type: application/json" \
  -H "X-API-Key: sk_live_abc123_def456" \
  -d '{
    "email": "jane@example.com"
  }'

​
Error responses

If the API key is missing or invalid, the API returns a 401 Unauthorized response. 
{
  "error": {
    "code": "unauthorized",
    "message": "API key is required"
  }
}