API key format
API keys follow this format:Authenticating requests
Include your API key in theX-API-Key header of every request.
Error responses
If the API key is missing or invalid, the API returns a401 Unauthorized response.
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"
}'
const response = await fetch("https://pub-api.conversion.ai/api/v2/contacts", {
method: "POST",
headers: {
"Content-Type": "application/json",
"X-API-Key": "sk_live_abc123_def456",
},
body: JSON.stringify({
email: "jane@example.com",
}),
});
const data = await response.json();
import requests
response = requests.post(
"https://pub-api.conversion.ai/api/v2/contacts",
headers={
"Content-Type": "application/json",
"X-API-Key": "sk_live_abc123_def456",
},
json={
"email": "jane@example.com",
},
)
data = response.json()
Getting Started
Authentication
Authenticate your API requests using an API key.
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"
}'
const response = await fetch("https://pub-api.conversion.ai/api/v2/contacts", {
method: "POST",
headers: {
"Content-Type": "application/json",
"X-API-Key": "sk_live_abc123_def456",
},
body: JSON.stringify({
email: "jane@example.com",
}),
});
const data = await response.json();
import requests
response = requests.post(
"https://pub-api.conversion.ai/api/v2/contacts",
headers={
"Content-Type": "application/json",
"X-API-Key": "sk_live_abc123_def456",
},
json={
"email": "jane@example.com",
},
)
data = response.json()
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.
You can generate and manage API keys from the Settings > API Keys page in the Conversion dashboard.
Was this page helpful?