# Ciela AI, Developer Reference

> API reference, authentication, and integration guide for Ciela AI (ciela.ai).

---

## Authentication

Ciela AI uses Supabase for authentication with cookie-based sessions. Most API endpoints require an authenticated session.

OAuth flows supported:
- Google (for Calendar integration)
- Zoom (for meeting scheduling)
- LinkedIn (browser automation via connected account)
- Stripe Connect (for collecting client payments)

---

## API Endpoints

All endpoints are at `https://ciela.ai/api/...`

### Content Generation

| Endpoint | Method | Description |
|----------|--------|-------------|
| /api/generate-cold-email | POST | Generate cold email copy |
| /api/generate-linkedin-dm | POST | Generate LinkedIn DM |
| /api/generate-linkedin-comment | POST | Generate LinkedIn comment |
| /api/generate-linkedin-connection-request | POST | Generate connection request message |
| /api/generate-linkedin-hook | POST | Generate LinkedIn post hook |
| /api/generate-linkedin-jargon-decoder | POST | Decode LinkedIn jargon |
| /api/generate-follow-up-sequence | POST | Generate follow-up email sequence |
| /api/generate-proposal | POST | Generate sales proposal |
| /api/generate-sales-pitch | POST | Generate sales pitch |
| /api/generate-subject-lines | POST | Generate email subject lines |
| /api/generate-corporate-bs | POST | Generate corporate jargon |
| /api/generate-agency-names | POST | Generate agency name ideas |
| /api/generate-agent-prompt | POST | Generate AI agent system prompt |
| /api/humanize-text | POST | Humanize AI-written text |
| /api/score-linkedin-profile | POST | Score a LinkedIn profile |
| /api/score-lead-qualification | POST | Score lead qualification |
| /api/enrich-company-data | POST | Enrich company data |
| /api/check-email-domain | POST | Check email domain deliverability |

### Campaigns

| Endpoint | Method | Description |
|----------|--------|-------------|
| /api/campaigns | GET, POST | List or create campaigns |
| /api/campaigns/[id] | GET, PATCH, DELETE | Manage a campaign |
| /api/campaigns/[id]/status | GET | Get campaign status |
| /api/campaigns/[id]/metrics | GET | Get campaign analytics |
| /api/campaigns/[id]/clone | POST | Duplicate a campaign |
| /api/scale/create | POST | Create or launch a LinkedIn campaign from the builder |

### Email

| Endpoint | Method | Description |
|----------|--------|-------------|
| /api/email/campaigns | GET, POST | Email campaigns |
| /api/email/campaigns/[id] | GET, PATCH | Manage email campaign |
| /api/email/campaigns/[id]/launch | POST | Start email campaign |
| /api/email/campaigns/[id]/sends | GET | Campaign send stats |
| /api/email/contacts/import | POST | Import contacts |
| /api/email/contacts/lists | GET, POST | Manage contact lists |
| /api/email/accounts | GET, POST | Email account setup |
| /api/email/accounts/test | POST | Test email account config |
| /api/email/track/open | GET | Email open tracking pixel |
| /api/email/track/click | GET | Email click tracking redirect |
| /api/email/unsubscribe | GET | Handle unsubscribe |
| /api/email/stats | GET | Campaign statistics |

### Leads

| Endpoint | Method | Description |
|----------|--------|-------------|
| /api/leads | GET, POST | Lead management |
| /api/leads/[id] | GET, PATCH, DELETE | Individual lead |
| /api/leads/[id]/contacts | GET, POST | Lead contacts |
| /api/leads/[id]/import | POST | Import contacts to lead list |
| /api/leads/ciela | POST | Search Ciela lead database |
| /api/leads/ciela/[runId] | GET | Lead search run status |
| /api/leads/ciela/credits | GET | Remaining search credits |

### Flows / Automation

| Endpoint | Method | Description |
|----------|--------|-------------|
| /api/flows | GET, POST | Workflow management |
| /api/flows/[id] | GET, PATCH, DELETE | Individual workflow |
| /api/flows/[id]/launch | POST | Start workflow |
| /api/flows/[id]/enroll | POST | Enroll contact in workflow |
| /api/flows/[id]/enrollments | GET | View workflow enrollments |
| /api/flows/process | POST | Process workflow queue |

### Per-Prospect AI Demos

| Endpoint | Method | Description |
|----------|--------|-------------|
| /api/demos | POST | Provision a per-prospect demo kit |
| /api/demos | GET | List demos for the operator |
| /api/demos/[slug]/chat | POST | Chat-demo streaming endpoint |
| /api/demos/track/hub | GET | Demo hub redirect + analytics |

### Inbox

| Endpoint | Method | Description |
|----------|--------|-------------|
| /api/inbox/threads | GET | List inbox threads |
| /api/inbox/threads/[id] | GET, PATCH | Thread detail and updates |
| /api/inbox/linkedin/reply | POST | Send a LinkedIn reply |
| /api/inbox/email/reply | POST | Send an email reply |

### Ciela Assistant

| Endpoint | Method | Description |
|----------|--------|-------------|
| /api/ciela/chat | POST | Ciela chat (streaming) |
| /api/ciela/sessions | GET, POST | Chat session management |
| /api/ciela/brief | POST | Generate a campaign brief |

### Checkout

| Endpoint | Method | Description |
|----------|--------|-------------|
| /api/checkout | POST | Create Stripe checkout session for subscriptions |

### Profile & Settings

| Endpoint | Method | Description |
|----------|--------|-------------|
| /api/profile | GET, PATCH | User profile |
| /api/profile/ai-keys | GET, POST | Manage AI API keys |
| /api/profile/avatar | POST | Upload avatar |
| /api/dashboard-init | GET | Dashboard initialization data |

### Integrations

| Endpoint | Method | Description |
|----------|--------|-------------|
| /api/integrations/google/authorize | GET | Start Google OAuth |
| /api/integrations/google/callback | GET | Google OAuth callback |
| /api/integrations/google/disconnect | POST | Revoke Google access |
| /api/integrations/zoom/authorize | GET | Start Zoom OAuth |
| /api/integrations/zoom/callback | GET | Zoom OAuth callback |
| /api/linkedin/connect | POST | Connect LinkedIn account |
| /api/linkedin/disconnect | POST | Disconnect LinkedIn |

### Webhooks

| Endpoint | Description |
|----------|-------------|
| /api/webhook/stripe | Stripe event webhook |

---

## External Integrations Supported

- **Stripe**, payments and Stripe Connect for client billing
- **Google Calendar**, appointment scheduling
- **Zoom**, meeting creation and scheduling
- **LinkedIn**, outreach automation via browser automation
- **Twilio**, phone numbers and calling
- **Resend**, transactional and campaign email
- **OpenAI**, content generation (GPT-4)
- **Vapi**, AI voice calling
- **AssemblyAI**, audio transcription
- **Ideogram / FAL.ai**, AI image generation