Authentication Overview

​

Authentication Method

import requests

api_key = "cs_live_your_api_key_here"
headers = {"X-API-Key": api_key}

response = requests.get(
    "https://api.coldsend.pro/api/public/v1/campaigns",
    headers=headers
)

const apiKey = "cs_live_your_api_key_here";

const response = await fetch("https://api.coldsend.pro/api/public/v1/campaigns", {
  method: "GET",
  headers: {
    "X-API-Key": apiKey,
    "Content-Type": "application/json"
  }
});

const data = await response.json();

curl -H "X-API-Key: cs_live_your_api_key_here" \
  https://api.coldsend.pro/api/public/v1/campaigns

​

Authentication Errors

{
  "detail": "API key required. Include your API key in X-API-Key header."
}

{
  "detail": "Invalid or revoked API key"
}

{
  "detail": "Missing required scopes: campaigns:write",
  "required": ["campaigns:write"],
  "granted": ["sender_accounts:read"]
}

​

Best Practices

1. Store API keys securely — Use environment variables or a secrets manager. Never hardcode them.
2. Use granular scopes — Create API keys with minimal required scopes for each integration.
3. Monitor key usage — Review which keys are being used and revoke unused ones.
4. Implement error handling — Handle HTTP 401 and 403 responses gracefully.

​

Next Steps