Firmalar

Firma oluştur

Yeni firma açar (durum verilmezse Prospect, sorumlu isteği yapan kullanıcı). Aynı adda firma varsa 409 exists, benzer adlar varsa 409 similar döner ve similar listesi gelir — yine de açmak için confirm_new: true gönderin. İsteğe bağlı olarak ilk kişi de açılır.

POST/api/v1/customers

Yetkilendirme

Authorizationheaderzorunlu

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

Modül: MüşterilerKapsam: crm.write

Gövde application/json

namestringzorunlu

Firma adı (en çok 200 karakter).

statusstringisteğe bağlıvarsayılan: Prospect

Durum.

DeğerlerACProspect

citystringisteğe bağlı

Şehir.

sectorstringisteğe bağlı

Sektör.

phonestringisteğe bağlı

Telefon.

websitestringisteğe bağlı

Web sitesi.

addressstringisteğe bağlı

Adres.

notestringisteğe bağlı

Not.

owner_idintegeristeğe bağlı

Sorumlu kullanıcı (yalnız yönetici).

visit_period_daysintegeristeğe bağlı

Kaç günde bir ziyaret edilmeli.

potential_kgnumberisteğe bağlı

Aylık potansiyel miktar (kurulumun ana biriminde).

contact_namestringisteğe bağlı

İlk kişinin adı (ana kişi olur).

contact_titlestringisteğe bağlı

İlk kişinin unvanı.

contact_emailstringisteğe bağlı

İlk kişinin e-postası.

contact_phonestringisteğe bağlı

İlk kişinin telefonu.

confirm_newbooleanisteğe bağlı

Benzer adlar olsa da aç.

Hatalar

HTTP	error	Anlamı
`400`	`invalid`	Eksik ya da geçersiz alan (`message` ayrıntıyı verir).
`409`	`exists`	Bu adla firma var (`customer` alanında döner).
`409`	`similar`	Benzer adlı firmalar var (`similar`); `confirm_new: true` ile yine açılır.

İstek

curl -X POST https://ornek.solk.app/api/v1/customers \
  -H "Authorization: Bearer $SOLK_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "Kuzey Plastik Sanayi",
  "city": "Bursa",
  "sector": "Plastik",
  "phone": "+90 224 555 01 02",
  "website": "kuzeyplastik.com.tr",
  "contact_name": "Selin Kara",
  "contact_title": "Satın Alma Müdürü",
  "contact_email": "selin.kara@kuzeyplastik.com.tr",
  "confirm_new": true
}'

const res = await fetch("https://ornek.solk.app/api/v1/customers", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.SOLK_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "name": "Kuzey Plastik Sanayi",
    "city": "Bursa",
    "sector": "Plastik",
    "phone": "+90 224 555 01 02",
    "website": "kuzeyplastik.com.tr",
    "contact_name": "Selin Kara",
    "contact_title": "Satın Alma Müdürü",
    "contact_email": "selin.kara@kuzeyplastik.com.tr",
    "confirm_new": true
  }),
});
const data = await res.json();

import os, requests

r = requests.post(
    "https://ornek.solk.app/api/v1/customers",
    headers={"Authorization": f"Bearer {os.environ['SOLK_API_KEY']}"},
    json={
        "name": "Kuzey Plastik Sanayi",
        "city": "Bursa",
        "sector": "Plastik",
        "phone": "+90 224 555 01 02",
        "website": "kuzeyplastik.com.tr",
        "contact_name": "Selin Kara",
        "contact_title": "Satın Alma Müdürü",
        "contact_email": "selin.kara@kuzeyplastik.com.tr",
        "confirm_new": True
    },
)
print(r.json())

Yanıt

{
  "customer": {
    "act": {
      "addr": "Bursa",
      "c": 31,
      "mail": "selin.kara@kuzeyplastik.com.tr",
      "n": "Kuzey Plastik Sanayi",
      "tel": "+90 224 555 01 02",
      "url": "/customers/31",
      "wa": "902245550102",
      "who": "Selin Kara"
    },
    "active": true,
    "address": "",
    "at_risk": false,
    "barrier": "",
    "can_edit": true,
    "city": "Bursa",
    "commit_kg": null,
    "competitors": [],
    "contacts": [
      {
        "customer": "Kuzey Plastik Sanayi",
        "customer_id": 31,
        "department": "",
        "email": "selin.kara@kuzeyplastik.com.tr",
        "id": 58,
        "is_former": false,
        "is_main": true,
        "name": "Selin Kara",
        "note": "",
        "phone": "",
        "rid": "003URRQi11tfUY7",
        "title": "Satın Alma Müdürü",
        "wa": ""
      }
    ],
    "created_at": "2026-10-02T20:07:00",
    "currency": "EUR",
    "currency_default": "",
    "demos": [],
    "events": [
      {
        "badge": null,
        "dot": "#94a3b8",
        "icon": "building",
        "kind": "firma",
        "note": "",
        "opp_id": null,
        "planned": false,
        "state": null,
        "sub": "Firma #31 · Deniz Aksoy",
        "title": "Firma kaydı açıldı",
        "url": "",
        "when": "2026-10-02",
        "who": ""
      }
    ],
    "extra_kg": null,
    "id": 31,
    "initials": "KP",
    "last_visit": null,
    "main_contact": {
      "email": "selin.kara@kuzeyplastik.com.tr",
      "name": "Selin Kara",
      "phone": "",
      "wa": ""
    },
    "mgmt_note": "",
    "mgmt_support": false,
    "name": "Kuzey Plastik Sanayi",
    "next_visit_due": null,
    "note": "",
    "offers": [],
    "open_actions": [],
    "open_opps": 0,
    "opps": [],
    "orders": [],
    "our_kg_current": null,
    "our_kg_target": null,
    "owner": {
      "full_name": "Deniz Aksoy",
      "id": 1,
      "role": "admin",
      "role_label": "Yönetici",
      "username": "admin"
    },
    "pending_state": null,
    "period": 180,
    "phone": "+90 224 555 01 02",
    "potential_kg": null,
    "prices": [],
    "priority_score": 0.0,
    "rid": "001QJi5Zr1Hk2VH",
    "sector": "Plastik",
    "share_current": null,
    "share_start": null,
    "share_target": null,
    "status": "Prospect",
    "status_label": "Prospect",
    "supplier_note": "",
    "threads": [],
    "threads_n": 0,
    "unit": "kg",
    "visit_overdue_days": 0,
    "visit_period_days": null,
    "visit_postponed_until": null,
    "visit_state": "none",
    "visits": [],
    "website": "kuzeyplastik.com.tr"
  },
  "ok": true
}

{
  "error": "similar",
  "message": "Benzer adlı firma var — mevcut kaydı seçin ya da confirm_new=1 ile yeni açın.",
  "ok": false,
  "similar": [
    {
      "active": true,
      "at_risk": false,
      "city": "Kocaeli",
      "currency": "EUR",
      "currency_default": "",
      "id": 2,
      "initials": "FA",
      "last_visit": "2026-09-24",
      "main_contact": {
        "email": "elif.karaca@filizambalaj.example",
        "name": "Elif Karaca",
        "phone": "0 (262) 000 27 12",
        "wa": "902620002712"
      },
      "name": "Filiz Ambalaj Ltd. Şti.",
      "next_visit_due": "2026-12-23",
      "open_opps": 1,
      "owner": {
        "full_name": "Deniz Aksoy",
        "id": 1,
        "role": "admin",
        "role_label": "Yönetici",
        "username": "admin"
      },
      "pending_state": "soon",
      "period": 90,
      "phone": "0 (262) 000 83 56",
      "potential_kg": 40000.0,
      "rid": "001rutEPiRkEPfD",
      "sector": "Gıda ambalajı",
      "status": "AC",
      "status_label": "Aktif Müşteri",
      "unit": "kg",
      "visit_overdue_days": -82,
      "visit_state": "ok"
    }
  ]
}

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