Skip to main content
POST
/
leads
Error
A valid request URL is required to generate request examples
{
  "http_code": 201,
  "status": "success",
  "message": "Lead created",
  "data": {
    "id": 42,
    "title": "Acme Corp",
    "created_at": "2026-04-07T12:00:00.000Z"
  }
}

Authorizations

X-API-Key
string
header
required

Your Flozy API key. Starts with flz_live_.

Body

application/json
title
string
required
Maximum string length: 200
Example:

"Acme Corp"

description
string | null
short_description
string | null
Example:

"Enterprise SaaS deal"

tag
string | null
Example:

"hot"

due_date
string | null
Example:

"2026-09-30"

ongoing
boolean
Example:

false

lead_status
integer

Status ID. Use GET /lead-statuses to discover IDs.

Example:

3

Response

Lead created.