Skip to main content

​
1. Get your API key

Navigate to Developer Settings in your Socrates CRM dashboard and create a new API key. Your key will look like sk_xxx....
Store your API key securely. It provides full access to your account’s CRM data.

​
2. Make your first request

Retrieve your contacts to verify everything is working: 
curl -X GET "https://api.socrateslabs.io/api/contacts?page=1&page_size=5" \
  -H "X-API-Key: sk_your_api_key_here"

​
3. Inspect the response

A successful response returns paginated results: 
{
  "items": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "full_name": "Jane Smith",
      "emails": ["jane@acme.com"],
      "job_title": "VP of Engineering",
      "company_id": "...",
      "created_at": "2026-01-15T10:30:00Z",
      "updated_at": "2026-02-20T14:00:00Z"
    }
  ],
  "total": 42,
  "page": 1,
  "page_size": 5,
  "total_pages": 9
}

​
Next steps