API Reference

112 live endpoints. Built API-first for AI agents and custom integrations. Full CRM operations via a single API key.

Live & Ready

The Clozup API is live in production. Get your API key from Settings → API Keys in the dashboard, or call POST /api/v1/api-keys programmatically.

Base URL

Production

https://api.clozup.ai/api/v1

Authentication

All requests require an API key (clz_ prefix) or a Clerk JWT in the Authorization header:

API Key Authentication

curl "https://api.clozup.ai/api/v1/deals" \
  -H "Authorization: Bearer clz_your_api_key_here"

Keep your API key secret

API keys are hashed (SHA-256) on our servers. Never expose keys in client-side code or public repos. Revoke immediately if compromised.

Core CRM

Leads

Method	Endpoint	Description
`GET`	`/leads`	List leads with pagination & filters
`GET`	`/leads/:id`	Get lead details
`GET`	`/leads/:id/360`	Full 360° view: deals, activities, notes, calls
`POST`	`/leads`	Create a lead
`PATCH`	`/leads/:id`	Update lead fields
`POST`	`/leads/:id/assign`	Assign to team member

Deals & Pipeline

Method	Endpoint	Description
`GET`	`/deals`	List deals with stage filtering
`GET`	`/deals/:id`	Get deal with full context
`POST`	`/deals`	Create a deal
`PATCH`	`/deals/:id`	Update deal fields
`POST`	`/deals/:id/move`	Move to another pipeline stage
`GET`	`/deals/stages`	List pipeline stages

Tasks

Method	Endpoint	Description
`GET`	`/tasks`	List tasks (filter by status, priority)
`POST`	`/tasks`	Create a follow-up task
`POST`	`/tasks/:id/complete`	Mark task as completed

Activities & Notes

Method	Endpoint	Description
`GET`	`/activities`	List activities
`POST`	`/activities`	Log an activity (call, email, meeting, etc.)
`POST`	`/notes`	Add a note to a deal or lead

AI & Intelligence

Agent-Native

These endpoints are designed for AI agents — risk scoring, memory, and buying signals are computed server-side in pure Rust. No LLM calls, instant responses.

Deal Intelligence

Method	Endpoint	Description
`GET`	`/deals/:id/intelligence`	Risk score, days in stage, suggested action
`GET`	`/deals/at-risk`	All deals needing immediate attention

Agent Memory

Method	Endpoint	Description
`GET`	`/deals/:id/memory`	Read persistent agent context notes
`POST`	`/deals/:id/memory`	Write a memory entry with tags

Buying Signals

Method	Endpoint	Description
`GET`	`/signals`	Detect email opens, activity gaps, overdue follow-ups

Email (AgentMail)

Method	Endpoint	Description
`POST`	`/deals/:id/email-inbox`	Provision a dedicated email inbox for a deal
`GET`	`/deals/:id/emails`	List emails in the deal inbox
`POST`	`/deals/:id/emails/send`	Send email from deal inbox
`POST`	`/deals/:id/emails/reply/:message_id`	Reply to an email thread

Real-Time Events

Method	Endpoint	Description
`GET`	`/events`	SSE stream — subscribe to deal.updated, signal.detected, etc.

Subscribe to Events

curl -N "https://api.clozup.ai/api/v1/events?types=deal.updated,signal.detected" \
  -H "Authorization: Bearer clz_your_key" \
  -H "Accept: text/event-stream"

Webhooks

Method	Endpoint	Description
`GET`	`/webhooks`	List configured webhooks
`POST`	`/webhooks`	Create a webhook (deal.created, deal.stage_changed, etc.)
`DELETE`	`/webhooks/:id`	Delete a webhook

API Key Management

Method	Endpoint	Description
`GET`	`/api-keys`	List API keys for your org
`POST`	`/api-keys`	Create a new API key
`DELETE`	`/api-keys/:id`	Revoke an API key

Analytics

Method	Endpoint	Description
`GET`	`/analytics/overview`	Pipeline stats, total deals, value, win rate
`GET`	`/performance/leaderboard`	Team performance rankings

Agent Workflow

The recommended workflow for an AI agent operating Clozup:

Daily Agent Loop

1. GET /signals?score_min=70        → Check buying signals
2. GET /deals/at-risk               → Find deals needing attention  
3. GET /deals/:id/intelligence      → Get risk score + suggested action
4. GET /deals/:id/memory            → Read persistent context
5. POST /activities                 → Log actions taken
6. POST /deals/:id/memory           → Write learnings for next cycle
7. POST /deals/:id/move             → Advance pipeline stage

Response Format

Standard Response

{
  "data": { ... },
  "meta": {
    "page": 1,
    "per_page": 25,
    "total": 142
  }
}

Intelligence Response

{
  "data": {
    "risk_score": 65,
    "risk_level": "medium",
    "days_in_stage": 12,
    "days_since_activity": 8,
    "risk_factors": ["No activity in 8 days", "High value deal stalling"],
    "suggested_action": "Schedule a follow-up call"
  }
}

Rate Limits

30 requests per burst
1 request per 500ms sustained
HTTP 429 on limit exceeded — back off and retry

Full Endpoint Catalog

For the complete list of all 112 endpoints with request/response schemas, see the live API documentation:

Live Docs

curl https://api.clozup.ai/api/v1/public/docs | jq

The /public/docs endpoint is always up-to-date and requires no authentication.

Feature Access

Security & Privacy