# 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/campaigns/trigger-processing | POST | Process campaign queue |

### 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 |
| /api/leads/google-maps | POST | Google Maps lead scraping |

### 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 |

### Dialer

| Endpoint | Method | Description |
|----------|--------|-------------|
| /api/dialer/script | GET | Get call script for contact |
| /api/dialer/log | POST | Log call result |
| /api/dialer/ai-config | GET | Get AI voice configuration |
| /api/dialer/contacts/[id] | GET | Get contact for dialer |

### Payments

| Endpoint | Method | Description |
|----------|--------|-------------|
| /api/checkout | POST | Create Stripe checkout session |
| /api/payments/config | GET, POST | Payment settings |
| /api/payments/stripe-connect | POST | Start Stripe Connect flow |
| /api/payments/stripe-connect/callback | GET | Stripe Connect OAuth callback |
| /api/payments/summary | GET | Payment history |

### Contracts

| Endpoint | Method | Description |
|----------|--------|-------------|
| /api/contracts | GET, POST | Contract management |
| /api/contracts/[id] | GET, PATCH | Individual contract |
| /api/contracts/[id]/send | POST | Send contract for signature |

### Booking

| Endpoint | Method | Description |
|----------|--------|-------------|
| /api/booking | GET, POST | Booking page settings |
| /api/booking/page | GET | Public booking page data |
| /api/booking/slots | GET | Available time slots |
| /api/booking/bookings | GET, POST | Manage bookings |

### 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 |
| /api/check-subscription | GET | Verify subscription status |
| /api/check-trial-status | GET | Trial status |

### 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