API Reference

Complete reference for all LeadFlowX API endpoints.

Authentication

Most endpoints require session authentication (cookie-based). Webhook endpoints use token-based auth via the URL path.

Base URL

https://leadflowx-neon.vercel.app/api

Endpoints by Category

Leads

GET

/api/leads

List leads with optional stage/search filters

Auth: Session

POST

/api/leads

Create a new lead

Auth: Session

GET

/api/leads/[id]

Get lead details with events and agent actions

Auth: Session

PUT

/api/leads/[id]

Update lead fields

Auth: Session

DELETE

/api/leads/[id]

Delete a lead

Auth: Session

POST

/api/leads/[id]/close

Close lead as won or lost

Auth: Session

GET

/api/leads/[id]/replies

Get email replies for a lead

Auth: Session

GET

/api/leads/[id]/sequence

Get email sequence for a lead

Auth: Session

POST

/api/leads/[id]/sequence

Create email sequence

Auth: Session

PUT

/api/leads/[id]/sequence

Update/activate/send/cancel sequence

Auth: Session

Webhooks

POST

/api/webhook/[token]

Ingest a lead via per-user webhook

Auth: Token (URL)

POST

/api/webhooks/lead

Ingest a lead (general webhook)

Auth: None

Email

GET

/api/email-accounts

List email accounts

Auth: Session

POST

/api/email-accounts

Add email account

Auth: Session

PUT

/api/email-accounts

Update email account

Auth: Session

DELETE

/api/email-accounts

Delete email account

Auth: Session

POST

/api/email-accounts/test

Verify SMTP connection

Auth: None

POST

/api/email-accounts/send-test

Send a test email

Auth: None

POST

/api/email-accounts/imap-detect

Auto-detect IMAP settings

Auth: None

AI Agents

GET

/api/agents/config

List agent configurations

Auth: Session

PUT

/api/agents/config

Update agent config (enable/disable)

Auth: Session

POST

/api/agents/run

Run an agent (batch mode)

Auth: Session

POST

/api/agents/enrich

Enrich a single lead

Auth: Session

POST

/api/agents/score

Score a single lead

Auth: Session

POST

/api/agents/draft

Draft outreach for a lead

Auth: Session

GET

/api/agents/pipeline

List leads ready for processing

Auth: Session

POST

/api/agents/pipeline

Run full pipeline for a lead

Auth: Session

Queue & Settings

GET

/api/queue

Get queue status

Auth: Session

POST

/api/queue

Queue actions (process, retry, toggle)

Auth: Session

GET

/api/settings

Get all settings

Auth: Session

PUT

/api/settings

Update settings

Auth: Session

GET

/api/sources

List available lead sources

Auth: Session

GET

/api/duplicates

List duplicate leads

Auth: Session

GET

/api/notifications

List notifications

Auth: Session

info

See the individual API pages for detailed request/response schemas for each endpoint.

arrow_backX / Twitter Automation Leadsarrow_forward