> For the complete documentation index, see [llms.txt](https://kilavuz.cubicl.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://kilavuz.cubicl.io/api-entegrasyonu/musteriler.md).

# Müşteriler

Uç noktalarında kullanılan veri türlerinin ve formatlarının tanımları **Modeller** bölümündedir.

## Müşterileri getir

> Arama kriterlerine uyan müşterileri getirir. Ad eşleşmesi, müşteri adındaki bir kelime verilen arama metniyle başlarsa gerçekleşir; büyük/küçük harfe duyarsızdır.

```json
{"openapi":"3.0.3","info":{"title":"Cubicl API","version":"1.0.0"},"tags":[{"name":"Müşteriler","description":"Uç noktalarında kullanılan veri türlerinin ve formatlarının tanımları **Modeller** bölümündedir."}],"servers":[{"url":"https://cubicl.io/api/v1","description":"Cubicl production API"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","description":"Entegrasyonlar sayfasından alınan erişim jetonu. Header: `Authorization: Bearer ERİŞİM_JETONUNUZ`."}},"schemas":{"ClientList":{"type":"array","items":{"$ref":"#/components/schemas/Client"}},"Client":{"type":"object","description":"Müşteri kaydı","properties":{"_id":{"type":"string"},"name":{"type":"string"},"phone":{"type":"string"},"email":{"type":"string"},"fullname":{"type":"string"},"contacts":{"type":"array","items":{"$ref":"#/components/schemas/Contact"}},"tax":{"$ref":"#/components/schemas/CustomerTax"},"customFields":{"type":"object","nullable":true,"additionalProperties":{"type":"string","nullable":true},"description":"Anahtarlar özel alan `id` değerleridir (alan adı değil). Tanımlar **CRM ayarlarını getir** yanıtındadır."},"portalCustomerManagerIds":{"type":"array","items":{"type":"string"}},"createdAt":{"$ref":"#/components/schemas/UnixTimestamp"}}},"Contact":{"type":"object","properties":{"name":{"type":"string"},"position":{"type":"string"},"phone":{"type":"string"},"email":{"type":"string"}}},"CustomerTax":{"type":"object","properties":{"administration":{"type":"string","description":"Vergi dairesi"},"number":{"type":"string","description":"Vergi numarası"},"address":{"type":"string","description":"Fatura adresi"}}},"UnixTimestamp":{"type":"number","description":"Unix zaman damgası (saniye)"},"ErrorCode":{"type":"object","required":["code"],"properties":{"code":{"type":"integer","description":"Uygulama hata kodu. HTTP durum kodu değildir."}}},"ValidationError":{"type":"object","properties":{"message":{"type":"string"},"errors":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}}}}}},"responses":{"ForbiddenCode":{"description":"İzin yok","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorCode"}}}},"ValidationFailed":{"description":"Doğrulama başarısız","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ValidationError"}}}}}},"paths":{"/crm/customers":{"get":{"tags":["Müşteriler"],"summary":"Müşterileri getir","operationId":"listCustomers","parameters":[{"name":"name","in":"query","description":"Müşteri adında kelime başı, büyük/küçük harf duyarsız arama","schema":{"type":"string"}},{"name":"limit","in":"query","schema":{"type":"number","default":10},"description":"Varsayılan: 10"},{"name":"skip","in":"query","schema":{"type":"number","default":0},"description":"Varsayılan: 0"},{"name":"includeAllFields","in":"query","description":"`true`: tüm alanlar. `false`: yalnızca isim. Varsayılan `false`.","schema":{"type":"string","enum":["true","false"],"default":"false"}},{"name":"email","in":"query","description":"Müşteri veya iletişim e-postasında arama","schema":{"type":"string"}}],"responses":{"200":{"description":"Müşteri listesi","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClientList"}}}},"403":{"$ref":"#/components/responses/ForbiddenCode"},"422":{"$ref":"#/components/responses/ValidationFailed"}},"description":"Arama kriterlerine uyan müşterileri getirir. Ad eşleşmesi, müşteri adındaki bir kelime verilen arama metniyle başlarsa gerçekleşir; büyük/küçük harfe duyarsızdır."}}}}
```

## Müşteri ekle

> Yeni bir müşteri kaydı oluşturur.

```json
{"openapi":"3.0.3","info":{"title":"Cubicl API","version":"1.0.0"},"tags":[{"name":"Müşteriler","description":"Uç noktalarında kullanılan veri türlerinin ve formatlarının tanımları **Modeller** bölümündedir."}],"servers":[{"url":"https://cubicl.io/api/v1","description":"Cubicl production API"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","description":"Entegrasyonlar sayfasından alınan erişim jetonu. Header: `Authorization: Bearer ERİŞİM_JETONUNUZ`."}},"schemas":{"CustomerWrite":{"type":"object","description":"Yeni müşteri oluştururken kullanılır. `name` zorunludur.","required":["name"],"properties":{"name":{"type":"string","description":"Arayüzde gösterilen ve aramada kullanılan kısa ad"},"fullname":{"type":"string","description":"Ad ve soyad"},"email":{"type":"string","description":"E-posta adresi"},"phone":{"type":"string","description":"Telefon"},"contacts":{"type":"array","items":{"$ref":"#/components/schemas/Contact"},"description":"Bu müşteride iletişim kurulacak kişiler"},"tax":{"$ref":"#/components/schemas/CustomerTax"},"customFields":{"type":"object","additionalProperties":true,"description":"Özel alan değerleri. Anahtar alan adı değil, **CRM ayarlarını getir** yanıtındaki `customFields[].id` değeridir."},"portalCustomerManagerIds":{"type":"array","items":{"type":"string"},"description":"Bu müşterinin portal aktivitelerinden bildirim alan kullanıcı ID listesi"}}},"Contact":{"type":"object","properties":{"name":{"type":"string"},"position":{"type":"string"},"phone":{"type":"string"},"email":{"type":"string"}}},"CustomerTax":{"type":"object","properties":{"administration":{"type":"string","description":"Vergi dairesi"},"number":{"type":"string","description":"Vergi numarası"},"address":{"type":"string","description":"Fatura adresi"}}},"Client":{"type":"object","description":"Müşteri kaydı","properties":{"_id":{"type":"string"},"name":{"type":"string"},"phone":{"type":"string"},"email":{"type":"string"},"fullname":{"type":"string"},"contacts":{"type":"array","items":{"$ref":"#/components/schemas/Contact"}},"tax":{"$ref":"#/components/schemas/CustomerTax"},"customFields":{"type":"object","nullable":true,"additionalProperties":{"type":"string","nullable":true},"description":"Anahtarlar özel alan `id` değerleridir (alan adı değil). Tanımlar **CRM ayarlarını getir** yanıtındadır."},"portalCustomerManagerIds":{"type":"array","items":{"type":"string"}},"createdAt":{"$ref":"#/components/schemas/UnixTimestamp"}}},"UnixTimestamp":{"type":"number","description":"Unix zaman damgası (saniye)"},"ErrorCode":{"type":"object","required":["code"],"properties":{"code":{"type":"integer","description":"Uygulama hata kodu. HTTP durum kodu değildir."}}}},"responses":{"ForbiddenCode":{"description":"İzin yok","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorCode"}}}}}},"paths":{"/crm/customers":{"post":{"tags":["Müşteriler"],"summary":"Müşteri ekle","operationId":"createCustomer","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CustomerWrite"}}}},"responses":{"200":{"description":"Müşteri detayları","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Client"}}}},"403":{"$ref":"#/components/responses/ForbiddenCode"},"422":{"description":"Geçersiz işlem","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorCode"}}}}},"description":"Yeni bir müşteri kaydı oluşturur."}}}}
```

## ID'ye göre müşteri getir

> Verilen ID'ye sahip müşteriyi getirir.

```json
{"openapi":"3.0.3","info":{"title":"Cubicl API","version":"1.0.0"},"tags":[{"name":"Müşteriler","description":"Uç noktalarında kullanılan veri türlerinin ve formatlarının tanımları **Modeller** bölümündedir."}],"servers":[{"url":"https://cubicl.io/api/v1","description":"Cubicl production API"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","description":"Entegrasyonlar sayfasından alınan erişim jetonu. Header: `Authorization: Bearer ERİŞİM_JETONUNUZ`."}},"parameters":{"IdPath":{"name":"id","in":"path","required":true,"schema":{"$ref":"#/components/schemas/ObjectId"},"description":"Kayıt ID'si"}},"schemas":{"ObjectId":{"type":"string","description":"MongoDB ObjectId"},"Client":{"type":"object","description":"Müşteri kaydı","properties":{"_id":{"type":"string"},"name":{"type":"string"},"phone":{"type":"string"},"email":{"type":"string"},"fullname":{"type":"string"},"contacts":{"type":"array","items":{"$ref":"#/components/schemas/Contact"}},"tax":{"$ref":"#/components/schemas/CustomerTax"},"customFields":{"type":"object","nullable":true,"additionalProperties":{"type":"string","nullable":true},"description":"Anahtarlar özel alan `id` değerleridir (alan adı değil). Tanımlar **CRM ayarlarını getir** yanıtındadır."},"portalCustomerManagerIds":{"type":"array","items":{"type":"string"}},"createdAt":{"$ref":"#/components/schemas/UnixTimestamp"}}},"Contact":{"type":"object","properties":{"name":{"type":"string"},"position":{"type":"string"},"phone":{"type":"string"},"email":{"type":"string"}}},"CustomerTax":{"type":"object","properties":{"administration":{"type":"string","description":"Vergi dairesi"},"number":{"type":"string","description":"Vergi numarası"},"address":{"type":"string","description":"Fatura adresi"}}},"UnixTimestamp":{"type":"number","description":"Unix zaman damgası (saniye)"},"ErrorCodeMessage":{"type":"object","required":["code","message"],"properties":{"code":{"type":"integer","description":"Uygulama hata kodu. HTTP durum kodu değildir."},"message":{"type":"string"}}},"ValidationError":{"type":"object","properties":{"message":{"type":"string"},"errors":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}}}}}},"responses":{"Forbidden":{"description":"İzin yok","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorCodeMessage"}}}},"NotFound":{"description":"Kaynak bulunamadı"},"ValidationFailed":{"description":"Doğrulama başarısız","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ValidationError"}}}}}},"paths":{"/crm/customers/{id}":{"get":{"tags":["Müşteriler"],"summary":"ID'ye göre müşteri getir","operationId":"getCustomer","parameters":[{"$ref":"#/components/parameters/IdPath"}],"responses":{"200":{"description":"Müşteri detayları","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Client"}}}},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"}},"description":"Verilen ID'ye sahip müşteriyi getirir."}}}}
```

## Müşteri güncelle

> Müşteri kaydını verilen alanlarla günceller.\<br>En az bir güncellenecek alan gönderilmelidir.\<br>Yalnızca gönderilen alanlar değişir.\<br>Bir alanı kaldırmak için \`null\` veya boş değer kullanın.\<br>\`customFields\` gönderilirse nesnenin tamamı yazılır; tek bir özel alan göndermek diğerlerini siler.\<br>Anahtarlar alan adı değil, \*\*CRM ayarlarını getir\*\* yanıtındaki \`customFields\[].id\` değerleridir.

```json
{"openapi":"3.0.3","info":{"title":"Cubicl API","version":"1.0.0"},"tags":[{"name":"Müşteriler","description":"Uç noktalarında kullanılan veri türlerinin ve formatlarının tanımları **Modeller** bölümündedir."}],"servers":[{"url":"https://cubicl.io/api/v1","description":"Cubicl production API"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","description":"Entegrasyonlar sayfasından alınan erişim jetonu. Header: `Authorization: Bearer ERİŞİM_JETONUNUZ`."}},"parameters":{"IdPath":{"name":"id","in":"path","required":true,"schema":{"$ref":"#/components/schemas/ObjectId"},"description":"Kayıt ID'si"}},"schemas":{"ObjectId":{"type":"string","description":"MongoDB ObjectId"},"CustomerUpdate":{"type":"object","description":"En az bir alan gönderilmelidir. Yalnızca gönderilen alanlar değişir. Gönderilmeyen alanlar aynı kalır.","properties":{"name":{"type":"string","description":"Arayüzde gösterilen ve aramada kullanılan kısa ad"},"fullname":{"type":"string","description":"Ad ve soyad"},"email":{"type":"string","description":"E-posta adresi"},"phone":{"type":"string","description":"Telefon"},"contacts":{"type":"array","items":{"$ref":"#/components/schemas/Contact"},"description":"Bu müşteride iletişim kurulacak kişiler"},"tax":{"allOf":[{"$ref":"#/components/schemas/CustomerTax"}],"description":"Vergi bilgileri. Gönderilirse nesnenin tamamı yazılır; tek alt alan göndermek diğerlerini siler."},"customFields":{"type":"object","additionalProperties":true,"description":"Özel alan değerleri. Anahtar alan adı değil, **CRM ayarlarını getir** yanıtındaki `customFields[].id` değeridir. Gönderilirse nesnenin tamamı yazılır; tek alan göndermek diğerlerini siler."},"portalCustomerManagerIds":{"type":"array","items":{"type":"string"},"description":"Bu müşterinin portal aktivitelerinden bildirim alan kullanıcı ID listesi"}}},"Contact":{"type":"object","properties":{"name":{"type":"string"},"position":{"type":"string"},"phone":{"type":"string"},"email":{"type":"string"}}},"CustomerTax":{"type":"object","properties":{"administration":{"type":"string","description":"Vergi dairesi"},"number":{"type":"string","description":"Vergi numarası"},"address":{"type":"string","description":"Fatura adresi"}}},"Client":{"type":"object","description":"Müşteri kaydı","properties":{"_id":{"type":"string"},"name":{"type":"string"},"phone":{"type":"string"},"email":{"type":"string"},"fullname":{"type":"string"},"contacts":{"type":"array","items":{"$ref":"#/components/schemas/Contact"}},"tax":{"$ref":"#/components/schemas/CustomerTax"},"customFields":{"type":"object","nullable":true,"additionalProperties":{"type":"string","nullable":true},"description":"Anahtarlar özel alan `id` değerleridir (alan adı değil). Tanımlar **CRM ayarlarını getir** yanıtındadır."},"portalCustomerManagerIds":{"type":"array","items":{"type":"string"}},"createdAt":{"$ref":"#/components/schemas/UnixTimestamp"}}},"UnixTimestamp":{"type":"number","description":"Unix zaman damgası (saniye)"},"ErrorCodeMessage":{"type":"object","required":["code","message"],"properties":{"code":{"type":"integer","description":"Uygulama hata kodu. HTTP durum kodu değildir."},"message":{"type":"string"}}},"ValidationError":{"type":"object","properties":{"message":{"type":"string"},"errors":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}}}}}},"responses":{"Forbidden":{"description":"İzin yok","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorCodeMessage"}}}},"NotFound":{"description":"Kaynak bulunamadı"},"ValidationFailed":{"description":"Doğrulama başarısız","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ValidationError"}}}}}},"paths":{"/crm/customers/{id}":{"put":{"tags":["Müşteriler"],"summary":"Müşteri güncelle","operationId":"updateCustomer","parameters":[{"$ref":"#/components/parameters/IdPath"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CustomerUpdate"}}}},"responses":{"200":{"description":"Müşteri detayları","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Client"}}}},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"}},"description":"Müşteri kaydını verilen alanlarla günceller.<br>En az bir güncellenecek alan gönderilmelidir.<br>Yalnızca gönderilen alanlar değişir.<br>Bir alanı kaldırmak için `null` veya boş değer kullanın.<br>`customFields` gönderilirse nesnenin tamamı yazılır; tek bir özel alan göndermek diğerlerini siler.<br>Anahtarlar alan adı değil, **CRM ayarlarını getir** yanıtındaki `customFields[].id` değerleridir."}}}}
```

## Müşteri sil

> Müşteri kaydını siler.

```json
{"openapi":"3.0.3","info":{"title":"Cubicl API","version":"1.0.0"},"tags":[{"name":"Müşteriler","description":"Uç noktalarında kullanılan veri türlerinin ve formatlarının tanımları **Modeller** bölümündedir."}],"servers":[{"url":"https://cubicl.io/api/v1","description":"Cubicl production API"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","description":"Entegrasyonlar sayfasından alınan erişim jetonu. Header: `Authorization: Bearer ERİŞİM_JETONUNUZ`."}},"parameters":{"IdPath":{"name":"id","in":"path","required":true,"schema":{"$ref":"#/components/schemas/ObjectId"},"description":"Kayıt ID'si"}},"schemas":{"ObjectId":{"type":"string","description":"MongoDB ObjectId"},"ErrorCodeMessage":{"type":"object","required":["code","message"],"properties":{"code":{"type":"integer","description":"Uygulama hata kodu. HTTP durum kodu değildir."},"message":{"type":"string"}}},"ValidationError":{"type":"object","properties":{"message":{"type":"string"},"errors":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}}}}}},"responses":{"Forbidden":{"description":"İzin yok","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorCodeMessage"}}}},"NotFound":{"description":"Kaynak bulunamadı"},"ValidationFailed":{"description":"Doğrulama başarısız","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ValidationError"}}}}}},"paths":{"/crm/customers/{id}":{"delete":{"tags":["Müşteriler"],"summary":"Müşteri sil","operationId":"deleteCustomer","parameters":[{"$ref":"#/components/parameters/IdPath"}],"responses":{"200":{"description":"İçerik yok"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"}},"description":"Müşteri kaydını siler."}}}}
```

## Müşteri görevlerini getir

> Müşterilere bağlı görevleri getirir. \`customerId\` verilmezse, sayfalanmış müşteri kümesine ait görevler döner.

```json
{"openapi":"3.0.3","info":{"title":"Cubicl API","version":"1.0.0"},"tags":[{"name":"Müşteriler","description":"Uç noktalarında kullanılan veri türlerinin ve formatlarının tanımları **Modeller** bölümündedir."}],"servers":[{"url":"https://cubicl.io/api/v1","description":"Cubicl production API"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","description":"Entegrasyonlar sayfasından alınan erişim jetonu. Header: `Authorization: Bearer ERİŞİM_JETONUNUZ`."}},"schemas":{"ObjectId":{"type":"string","description":"MongoDB ObjectId"},"TaskList":{"type":"array","items":{"$ref":"#/components/schemas/Task"}},"Task":{"type":"object","properties":{"_id":{"$ref":"#/components/schemas/ObjectId"},"name":{"type":"string"},"desc":{"type":"string"},"descIsRichText":{"type":"boolean"},"state":{"type":"string"},"start":{"type":"number","nullable":true},"deadline":{"type":"number","nullable":true},"private":{"type":"boolean"},"assignees":{"type":"array","items":{"type":"string"}},"assignedBy":{"type":"string"},"followers":{"type":"array","items":{"type":"string"}},"portalFollowers":{"type":"array","items":{"type":"string"}},"priority":{"type":"number","minimum":1,"maximum":5},"priorityScore":{"type":"number"},"group":{"type":"string"},"stepType":{"type":"string","enum":["none","steps","progress"]},"steps":{"oneOf":[{"$ref":"#/components/schemas/ProgressBar"},{"type":"array","items":{"$ref":"#/components/schemas/TaskStep"}}]},"customer":{"type":"object","nullable":true,"properties":{"_id":{"type":"string"},"name":{"type":"string"}}},"files":{"type":"array","items":{"type":"object","properties":{"_id":{"type":"string"},"name":{"type":"string"},"size":{"type":"string"}}}},"tags":{"type":"array","items":{"type":"string"}},"subtasks":{"type":"array","items":{"type":"string"}},"parent":{"type":"string","nullable":true},"breadcrumbs":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"group":{"type":"string"}}}},"email":{"type":"object","properties":{"emailUserId":{"type":"string"}}},"support":{"type":"object","properties":{"portalUser":{"type":"string"}}},"sharedWithCustomer":{"type":"boolean"},"workflowId":{"type":"string"},"workflowTaskCounts":{"type":"number"},"workflow":{"type":"object","properties":{"id":{"type":"string"},"templateId":{"type":"string"},"isCompleted":{"type":"boolean"},"taskflowId":{"type":"string"}}},"estimatedTime":{"type":"number"},"customFields":{"type":"object","additionalProperties":{"type":"string"}},"lastCopy":{"type":"boolean"},"trackingNumber":{"type":"number"},"createdAt":{"$ref":"#/components/schemas/UnixTimestamp"},"updatedAt":{"$ref":"#/components/schemas/UnixTimestamp"},"completedAt":{"$ref":"#/components/schemas/UnixTimestamp"},"archivedAt":{"type":"number","nullable":true}}},"ProgressBar":{"type":"object","properties":{"completed":{"type":"number"},"total":{"type":"number"}}},"TaskStep":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"desc":{"type":"string"},"assignees":{"type":"array","items":{"type":"string"}},"stepType":{"type":"string","enum":["steps","progress"]},"steps":{"type":"array","items":{"$ref":"#/components/schemas/TaskStep"}},"completed":{"oneOf":[{"type":"boolean"},{"type":"number"}]},"total":{"type":"number"}}},"UnixTimestamp":{"type":"number","description":"Unix zaman damgası (saniye)"},"ErrorCodeMessage":{"type":"object","required":["code","message"],"properties":{"code":{"type":"integer","description":"Uygulama hata kodu. HTTP durum kodu değildir."},"message":{"type":"string"}}},"ValidationError":{"type":"object","properties":{"message":{"type":"string"},"errors":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}}}}}},"responses":{"Forbidden":{"description":"İzin yok","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorCodeMessage"}}}},"NotFound":{"description":"Kaynak bulunamadı"},"ValidationFailed":{"description":"Doğrulama başarısız","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ValidationError"}}}}}},"paths":{"/crm/customers/tasks":{"get":{"tags":["Müşteriler"],"summary":"Müşteri görevlerini getir","description":"Müşterilere bağlı görevleri getirir. `customerId` verilmezse, sayfalanmış müşteri kümesine ait görevler döner.","operationId":"listCustomerTasks","parameters":[{"name":"customerId","in":"query","schema":{"$ref":"#/components/schemas/ObjectId"},"description":"Müşteri ID'si. Verilmezse sayfalanmış müşteri kümesinin görevleri döner."},{"name":"type","in":"query","schema":{"type":"string","enum":["all","tasks","support-requests","emails"]},"description":"Görev türü filtresi."},{"name":"skip","in":"query","schema":{"type":"number","default":0},"description":"Varsayılan: 0"},{"name":"limit","in":"query","schema":{"type":"number","minimum":1,"maximum":200,"default":200},"description":"1–200. Varsayılan: 200"},{"name":"orderBy","in":"query","schema":{"type":"string","enum":["_id","name","createdAt","updatedAt"],"default":"createdAt"},"description":"Sıralama alanı. Varsayılan: `createdAt`."},{"name":"orderDirection","in":"query","schema":{"type":"string","enum":["asc","desc"],"default":"desc"},"description":"`asc` veya `desc`. Varsayılan: `desc`."},{"name":"fields","in":"query","description":"Yanıta dahil edilecek alanların virgülle ayrılmış listesi","schema":{"type":"string"}}],"responses":{"200":{"description":"Görev listesi","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TaskList"}}}},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"}}}}}}
```

## CRM ayarlarını getir

> Kurumun CRM ayarlarını getirir (örneğin teklif aşamaları ve müşteri özel alanları). \`customFields\[].id\` değerleri, müşteri oluşturma ve güncellemede \`customFields\` nesnesinin anahtarı olarak kullanılır.

```json
{"openapi":"3.0.3","info":{"title":"Cubicl API","version":"1.0.0"},"tags":[{"name":"Müşteriler","description":"Uç noktalarında kullanılan veri türlerinin ve formatlarının tanımları **Modeller** bölümündedir."}],"servers":[{"url":"https://cubicl.io/api/v1","description":"Cubicl production API"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","description":"Entegrasyonlar sayfasından alınan erişim jetonu. Header: `Authorization: Bearer ERİŞİM_JETONUNUZ`."}},"schemas":{"CrmSettings":{"type":"object","properties":{"_id":{"type":"string"},"org":{"type":"string"},"stages":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"}}}},"customFields":{"type":"array","description":"Müşteri özel alan tanımları. `id` değerleri müşteri `customFields` nesnesinde anahtar olarak kullanılır.","items":{"type":"object","properties":{"id":{"type":"string","description":"Özel alan kimliği"},"name":{"type":"string","description":"Arayüzde gösterilen ad"}}}}}}}},"paths":{"/crm/settings":{"get":{"tags":["Müşteriler"],"summary":"CRM ayarlarını getir","operationId":"getCrmSettings","parameters":[{"name":"fields","in":"query","description":"Virgülle ayrılmış alan listesi. Boşsa tüm alanlar.","schema":{"type":"string"}}],"responses":{"200":{"description":"CRM ayarları","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CrmSettings"}}}},"422":{"description":"Geçersiz işlem"}},"description":"Kurumun CRM ayarlarını getirir (örneğin teklif aşamaları ve müşteri özel alanları). `customFields[].id` değerleri, müşteri oluşturma ve güncellemede `customFields` nesnesinin anahtarı olarak kullanılır."}}}}
```
