# Create a lead

`POST /api/v1/fairs/{id}/leads`

Records a lead at the fair stand; a next action opens a task for the owner.

## Path parameters

| Field | Type | Description |
|---|---|---|
| `id` (required) | integer | Fair id. |

## Body

| Field | Type | Description |
|---|---|---|
| `company` (required) | string | Company name. |
| `contact_name / title / phone / email` | string | Contact details. |
| `city / sector / website` | string | Company details. |
| `visitor_type` | string | Visitor type. Values: `Potansiyel müşteri`, `Mevcut müşteri`, `Tedarikçi`, `Rakip`, `Diğer` |
| `interest` | string | Interest. Values: `Sıcak`, `Ilık`, `Soğuk` |
| `products` | array<integer> | Products of interest. |
| `products_text` | string | Products (free text). |
| `potential_kg` | number | Monthly potential. |
| `timing` | string | Timing. Values: `Hemen`, `3 ay içinde`, `6 ay içinde`, `1 yıl+`, `Belirsiz` |
| `next_action` | string | Next action. Values: `Teklif gönder`, `Ziyaret planla`, `Numune gönder`, `Deneme planla`, `Bilgi gönder`, `Ara`, `Aksiyon yok` |
| `next_date` | string | Action date. |
| `owner_id` | integer | Owner. |
| `note / project_note / supplier / line / opp_type` | string | Other fields. |

## Response

```json 200
{
  "lead": {
    "can_edit": true,
    "city": "Konya",
    "company": "Anadolu Gıda Ambalaj",
    "contact_name": "Murat Er",
    "created_at": "2026-10-02T20:07:01",
    "customer_id": null,
    "email": "",
    "fair": "Ambalaj Fuarı 2026 (örnek)",
    "fair_id": 1,
    "id": 11,
    "initials": "AG",
    "interest": "Sıcak",
    "line": "",
    "next_action": "Numune gönder",
    "next_date": "2026-10-07",
    "note": "",
    "opp_id": null,
    "opp_type": "",
    "owner": {
      "full_name": "Deniz Aksoy",
      "id": 1,
      "role": "admin",
      "role_label": "Yönetici",
      "username": "admin"
    },
    "phone": "+90 533 555 33 44",
    "potential_kg": null,
    "products": "",
    "products_text": "",
    "project_note": "",
    "rid": "00QpWFogpnPsXu7",
    "sector": "",
    "status": "Yeni",
    "status_eff": "Yeni",
    "supplier": "",
    "task_id": 25,
    "timing": "",
    "title": "Genel Müdür",
    "unit": "kg",
    "visitor_type": "Potansiyel müşteri",
    "wa": "905335553344",
    "website": ""
  },
  "ok": true
}
```