Fliok Developer API

# Request

curl -X POST https://fliok.com/api/v1/leads \
  -H "Authorization: Bearer wa_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "phone": "+91 98765 43210",
    "name": "Asha Rao",
    "email": "asha@example.com",
    "source": "Partner portal",
    "stage": "Contacted",
    "owner": "urvi@yourcompany.com",
    "rating": 3,
    "dealValue": 250000,
    "tags": ["december"],
    "attributes": { "city": "Udaipur" },
    "note": "300 guests, wants a lake view"
  }'

# Response

// 201 Created (200 with "created": false when the number was already a lead)
{
  "created": true,
  "lead": {
    "id": "4ca441d8-6a95-4b45-9a60-4d5c3ec0f67a",
    "name": "Asha Rao",
    "phone": "919876543210",
    "email": "asha@example.com",
    "stage": { "id": "1e43…", "name": "Contacted", "color": "#a78bfa", "kind": "active" },
    "lostReason": null,
    "rating": 3,
    "source": "Partner portal",
    "owner": { "id": "c4f6…", "name": "Urvi", "email": "urvi@yourcompany.com" },
    "dealValue": 250000,
    "paidTotal": 0,
    "tags": ["december"],
    "attributes": { "city": "Udaipur" },
    "nextFollowUpAt": null,
    "captureCount": 1,
    "createdAt": "2026-09-14T10:00:00.000Z",
    "conversationId": null
  }
}

# Request

# Won leads, biggest deals first, 25 per page
curl "https://fliok.com/api/v1/leads?view=sys:won&sort=dealValue&dir=desc&pageSize=25" \
  -H "Authorization: Bearer wa_YOUR_API_KEY"

# Any filter the dashboard can build (URL-encode it)
curl -G "https://fliok.com/api/v1/leads" \
  --data-urlencode 'filter={"match":"all","conditions":[{"field":"source","op":"in","value":["Website"]},{"field":"rating","op":"gte","value":4}]}' \
  --data-urlencode "q=asha" \
  -H "Authorization: Bearer wa_YOUR_API_KEY"

# Response

// 200 OK — views: sys:open, sys:all, sys:unassigned, sys:new_today,
// sys:followups, sys:won, sys:lost, or the id of a view shared with your team
{
  "leads": [ { "id": "…", "name": "Asha Rao", "stage": { "name": "Won", "kind": "won" }, … } ],
  "total": 15,
  "page": 1,
  "pageSize": 25
}

# Request

# :id is our lead id OR the phone number
curl -X PATCH https://fliok.com/api/v1/leads/+919876543210 \
  -H "Authorization: Bearer wa_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "stage": "Lost", "lostReason": "Too expensive", "owner": "urvi@yourcompany.com", "addTags": ["priced-out"] }'

curl -X POST https://fliok.com/api/v1/leads/+919876543210/notes \
  -H "Authorization: Bearer wa_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "body": "Asked for a quote under 2L" }'

# Response

// PATCH → 200 OK. "changed" lists what actually moved; each is on the lead's timeline
{
  "lead": { "id": "…", "stage": { "name": "Lost", "kind": "lost" }, "lostReason": { "id": "…", "label": "Too expensive" }, … },
  "changed": ["stage_changed", "owner_changed", "tags_changed"]
}

// POST notes → 201 Created
{ "note": { "id": "510a…", "leadId": "4ca4…", "body": "Asked for a quote under 2L", "createdAt": "2026-09-14T10:05:00.000Z" } }

// An unknown name is refused, never guessed:
// 400 { "error": "invalid", "message": "There is no stage called \"Wonn\". GET /api/v1/pipeline lists the stages." }

# Request

curl -X POST https://fliok.com/api/v1/tasks \
  -H "Authorization: Bearer wa_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "leadId": "+919876543210", "type": "call", "title": "Call back with revised quote",
        "dueAt": "2026-09-16T11:00:00+05:30", "priority": "high", "assignee": "tushar@yourcompany.com" }'

curl "https://fliok.com/api/v1/tasks?status=overdue&pageSize=50" -H "Authorization: Bearer wa_YOUR_API_KEY"

curl -X PATCH https://fliok.com/api/v1/tasks/31089580-1422-48cc-becd-85c4e6689352 \
  -H "Authorization: Bearer wa_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "status": "done", "outcome": "Sent revised quote" }'

# Response

// POST → 201 Created; PATCH → 200 OK with the same shape
{
  "task": {
    "id": "31089580-1422-48cc-becd-85c4e6689352",
    "lead": { "id": "4ca4…", "name": "Asha Rao", "phone": "919876543210" },
    "type": "call",
    "title": "Call back with revised quote",
    "dueAt": "2026-09-16T05:30:00.000Z",
    "priority": "high",
    "status": "pending",
    "state": "pending",
    "assignee": { "id": "c4f6…", "name": "Tushar" },
    "completedAt": null,
    "outcome": null
  }
}

// GET → { "tasks": [ … ], "total": 3, "page": 1, "pageSize": 50,
//         "counts": { "overdue": 3, "today": 1, "upcoming": 7, "done": 40, "cancelled": 2 } }

# Request

curl https://fliok.com/api/v1/pipeline -H "Authorization: Bearer wa_YOUR_API_KEY"

# Response

// 200 OK — switch on "kind", not on your team's stage names
{
  "stages": [
    { "id": "2167…", "name": "New lead", "color": "#53bdeb", "kind": "initial", "position": 0 },
    { "id": "1e43…", "name": "Contacted", "color": "#a78bfa", "kind": "active", "position": 1 },
    { "id": "9b75…", "name": "Won", "color": "#00a884", "kind": "won", "position": 5 },
    { "id": "9502…", "name": "Lost", "color": "#f15c6d", "kind": "lost", "position": 6 }
  ],
  "lostReasons": [ { "id": "97e8…", "label": "Too expensive", "position": 1 } ],
  "initialStageId": "2167…"
}