Skip to main content

​
Base URL

All API requests use the following base URL: 
https://api.socrateslabs.io/api

​
Request format

  • All request bodies must be JSON with Content-Type: application/json
  • File uploads use Content-Type: multipart/form-data
  • UUIDs are used for all resource identifiers

​
Authentication

Include your API key in every request: 
curl -H "X-API-Key: sk_your_api_key_here"

​
Response format

All responses return JSON. Successful responses return the resource directly or a paginated wrapper: 
// Single resource
{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "full_name": "Jane Smith",
  "created_at": "2026-01-15T10:30:00Z",
  "updated_at": "2026-02-20T14:00:00Z"
}

// Paginated list
{
  "items": [],
  "total": 42,
  "page": 1,
  "page_size": 25,
  "total_pages": 2
}

​
Common patterns

PatternExample
List resourcesGET /api/contacts?page=1&page_size=25
Get by IDGET /api/contacts/{id}
CreatePOST /api/contacts
UpdatePUT /api/contacts/{id}
DeleteDELETE /api/contacts/{id}
Bulk deletePOST /api/contacts/bulk-delete

​
Endpoint groups

GroupPrefixDescription
Contacts/api/contactsPeople in your CRM
Companies/api/companiesOrganizations and teams
Deals/api/dealsSales pipeline deals
Activities/api/activitiesCalls, meetings, tasks
Notes/api/notesNotes on entities
Favorites/api/favoritesBookmarked records
Email Drafts/api/email-draftsEmail drafts
Email Templates/api/email-templatesEmail templates
Knowledge Base/api/kbKB documents
Chats/api/chatsAI chat conversations