Lead ekle

Fuar standında lead kaydeder; sonraki aksiyon verilirse sorumluya görev açılır.

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

Yetkilendirme

Authorizationheaderzorunlu

Bearer belirteci: API anahtarı (sk_…), OAuth erişim belirteci (mcp_…) ya da mobil oturum (xk_…).

Modül: Fuar leadleriKapsam: crm.write

Yol parametreleri

idintegerzorunlu

Fuar kimliği.

Gövde application/json

companystringzorunlu

Firma adı.

contact_name / title / phone / emailstringisteğe bağlı

Kişi bilgileri.

city / sector / websitestringisteğe bağlı

Firma bilgileri.

visitor_typestringisteğe bağlı

Ziyaretçi türü.

DeğerlerPotansiyel müşteriMevcut müşteriTedarikçiRakipDiğer

intereststringisteğe bağlıvarsayılan: Ilık

İlgi.

DeğerlerSıcakIlıkSoğuk

productsarray<integer>isteğe bağlı

İlgilendiği ürünler.

products_textstringisteğe bağlı

Ürünler (serbest metin).

potential_kgnumberisteğe bağlı

Aylık potansiyel.

timingstringisteğe bağlı

Zamanlama.

DeğerlerHemen3 ay içinde6 ay içinde1 yıl+Belirsiz

next_actionstringisteğe bağlı

Sonraki aksiyon.

DeğerlerTeklif gönderZiyaret planlaNumune gönderDeneme planlaBilgi gönderAraAksiyon yok

next_datestringisteğe bağlı

Aksiyon tarihi.

owner_idintegeristeğe bağlı

Sorumlu.

note / project_note / supplier / line / opp_typestringisteğe bağlı

Diğer alanlar.

Hatalar

HTTP	error	Anlamı
`400`	`invalid`	Eksik ya da geçersiz alan (`message` ayrıntıyı verir).
`404`	`not_found`	Kayıt bulunamadı.

İstek

curl -X POST https://ornek.solk.app/api/v1/fairs/1/leads \
  -H "Authorization: Bearer $SOLK_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "company": "Anadolu Gıda Ambalaj",
  "contact_name": "Murat Er",
  "title": "Genel Müdür",
  "phone": "+90 533 555 33 44",
  "interest": "Sıcak",
  "city": "Konya",
  "next_action": "Numune gönder",
  "next_date": "2026-10-07"
}'

const res = await fetch("https://ornek.solk.app/api/v1/fairs/1/leads", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.SOLK_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "company": "Anadolu Gıda Ambalaj",
    "contact_name": "Murat Er",
    "title": "Genel Müdür",
    "phone": "+90 533 555 33 44",
    "interest": "Sıcak",
    "city": "Konya",
    "next_action": "Numune gönder",
    "next_date": "2026-10-07"
  }),
});
const data = await res.json();

import os, requests

r = requests.post(
    "https://ornek.solk.app/api/v1/fairs/1/leads",
    headers={"Authorization": f"Bearer {os.environ['SOLK_API_KEY']}"},
    json={
        "company": "Anadolu Gıda Ambalaj",
        "contact_name": "Murat Er",
        "title": "Genel Müdür",
        "phone": "+90 533 555 33 44",
        "interest": "Sıcak",
        "city": "Konya",
        "next_action": "Numune gönder",
        "next_date": "2026-10-07"
    },
)
print(r.json())

Yanıt

{
  "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
}

Örnek yanıt örnek veriyle çalışan bir v22 kurulumundan alındı; listeler en çok iki öğeyle kısaltıldı.