API Endpoints

Complete reference for all available API endpoints.

Health

GET/v1/health

Check API status and version

Leads

GET/v1/leads

List all leads with pagination and filtering

GET/v1/leads/{id}

Retrieve a specific lead by ID

POST/v1/leads

Create a new lead

PUT/v1/leads/{id}

Update an existing lead

DELETE/v1/leads/{id}

Delete a lead

GET/v1/leads/{id}/score

Get AI-generated lead score and signals

Deals

GET/v1/deals

List all deals with pipeline stage filtering

POST/v1/deals

Create a new deal

PUT/v1/deals/{id}

Update deal stage, value, or metadata

POST/v1/deals/{id}/register

Proposals

POST/v1/proposals

Generate a new proposal from deal data

GET/v1/proposals/{id}

Retrieve proposal details and PDF URL

GET/v1/proposals/{id}/pdf

Download proposal as PDF

Agents

GET/v1/agents

List all AI agents

POST/v1/agents

Create and configure a new agent

POST/v1/agents/{id}/deploy

Deploy an agent to production

GET/v1/agents/{id}/metrics

Get agent performance metrics

Integrations

GET/v1/integrations

List configured integrations

POST/v1/integrations

Connect a new integration (CRM, PSA, M365)

DELETE/v1/integrations/{id}

Disconnect an integration

Webhooks

GET/v1/webhooks

List all webhook subscriptions

POST/v1/webhooks

Create a webhook subscription

PUT/v1/webhooks/{id}

Update webhook URL or events

DELETE/v1/webhooks/{id}

Delete a webhook subscription

# Example: Create a lead and get its AI score
curl -X POST https://api.simplicityitinc.com/v1/leads 
  -H “Authorization: Bearer sk_live_your_key” 
  -H “Content-Type: application/json” 
  -d '{
    “company”: “Acme Corp”,
    “contact_email”: “john@acme.com”,
    “industry”: “manufacturing”,
    “employees”: 250
  }'

# Response
{
  “id”: “lead_abc123”,
  “company”: “Acme Corp”,
  “score”: 87,
  “score_label”: “Hot”,
  “created_at”: “2026-03-23T12:00:00Z”
}