> 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/webhook.md).

# Webhook

Webhook'lar, Cubicl'ı diğer uygulamalarla entegre etmenizi sağlar. Seçtiğiniz işlem türü gerçekleştiğinde Cubicl, eklediğiniz webhook URL'sine bildirim gönderir.\
\
• Müşteri oluşturulduğunda\
• Müşteri güncellendiğinde\
• Müşteri silindiğinde\
• Görev oluşturulduğunda\
• Görev güncellendiğinde\
• Görev silindiğinde\
• Göreve aktivite eklendiğinde\
• Görev durumu değiştirildiğinde\
• Görev arşivlendiğinde\
• Görev arşivden geri yüklendiğinde\
• Zaman takibi kaydı eklendiğinde\
• Zaman takibi kaydı güncellendiğinde\
• Zaman takibi kaydı silindiğinde\
• Forma yanıt verildiğinde\
• İzin günü talebi geldiğinde\
• Hesaba giriş yapıldığında\
• Yazışma mesajı alındığında\
• Uygulama içi bildirim alındığında\
\
Webhook arayüzden de eklenebilir: [Navigasyon Menüsü > Diğer > Entegrasyon](https://cubicl.io/integrations) > Webhook Ayarları.\ <br>

#### Kimler bildirim alır?

• Görev ve zaman takibi türlerinde webhook'u bir projeyle ilişkilendirmeniz gerekir. Bildirim almak için o projedeki görevi görme yetkiniz olmalıdır.\
• Proje seçilmeyen diğer türlerde ilgili sayfanın iznine bakılır. Müşteri olaylarında Müşteriler sayfasını görme yetkiniz, izin günü talebinde İzin Günleri sayfasını görme yetkiniz gerekir. Forma yanıtında webhook sahibi formun kurumunda olmalıdır.\
• Hesaba giriş, uygulama içi bildirim ve yazışma mesajı doğrudan webhook'u ekleyen hesaba aittir; bu olaylar sizin hesabınızla ilgiliyse gönderilir.\
\
Her POST gövdesinde kebab-case `type` alanı vardır (`task-created`, `form-submitted` gibi).\
\
Olay gövdeleri **Modeller** bölümünde `Webhook*` şemaları olarak tanımlıdır.

## Webhook'ları getir

> Kimliği doğrulanmış kullanıcıya ait webhook kayıtlarını döndürür.

```json
{"openapi":"3.0.3","info":{"title":"Cubicl API","version":"1.0.0"},"tags":[{"name":"Webhook","description":"Webhook'lar, Cubicl'ı diğer uygulamalarla entegre etmenizi sağlar. Seçtiğiniz işlem türü gerçekleştiğinde Cubicl, eklediğiniz webhook URL'sine bildirim gönderir.<br><br>• Müşteri oluşturulduğunda<br>• Müşteri güncellendiğinde<br>• Müşteri silindiğinde<br>• Görev oluşturulduğunda<br>• Görev güncellendiğinde<br>• Görev silindiğinde<br>• Göreve aktivite eklendiğinde<br>• Görev durumu değiştirildiğinde<br>• Görev arşivlendiğinde<br>• Görev arşivden geri yüklendiğinde<br>• Zaman takibi kaydı eklendiğinde<br>• Zaman takibi kaydı güncellendiğinde<br>• Zaman takibi kaydı silindiğinde<br>• Forma yanıt verildiğinde<br>• İzin günü talebi geldiğinde<br>• Hesaba giriş yapıldığında<br>• Yazışma mesajı alındığında<br>• Uygulama içi bildirim alındığında<br><br>Webhook arayüzden de eklenebilir: [Navigasyon Menüsü > Diğer > Entegrasyon](https://cubicl.io/integrations) > Webhook Ayarları.<br><br><h3>Kimler bildirim alır?</h3>• Görev ve zaman takibi türlerinde webhook'u bir projeyle ilişkilendirmeniz gerekir. Bildirim almak için o projedeki görevi görme yetkiniz olmalıdır.<br>• Proje seçilmeyen diğer türlerde ilgili sayfanın iznine bakılır. Müşteri olaylarında Müşteriler sayfasını görme yetkiniz, izin günü talebinde İzin Günleri sayfasını görme yetkiniz gerekir. Forma yanıtında webhook sahibi formun kurumunda olmalıdır.<br>• Hesaba giriş, uygulama içi bildirim ve yazışma mesajı doğrudan webhook'u ekleyen hesaba aittir; bu olaylar sizin hesabınızla ilgiliyse gönderilir.<br><br>Her POST gövdesinde kebab-case `type` alanı vardır (`task-created`, `form-submitted` gibi).<br><br>Olay gövdeleri **Modeller** bölümünde `Webhook*` şemaları olarak tanımlıdır."}],"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":{"WebhookList":{"type":"array","items":{"$ref":"#/components/schemas/Webhook"}},"Webhook":{"type":"object","properties":{"_id":{"type":"string"},"type":{"$ref":"#/components/schemas/WebhookType"},"url":{"type":"string"},"group":{"type":"string","description":"Proje ID'si"},"user":{"type":"string"},"createdAt":{"$ref":"#/components/schemas/UnixTimestamp"},"updatedAt":{"$ref":"#/components/schemas/UnixTimestamp"}}},"WebhookType":{"type":"string","enum":["customer-created","customer-updated","customer-deleted","task-created","task-updated","task-deleted","posted-on-task","task-state-changed","task-archived","task-restored","timer-created","timer-updated","timer-deleted","form-submitted","time-off-requested","user-logged-in","chat-message-received","notification-received"]},"UnixTimestamp":{"type":"number","description":"Unix zaman damgası (saniye)"}}},"paths":{"/users/self/webhook":{"get":{"tags":["Webhook"],"summary":"Webhook'ları getir","operationId":"listWebhooks","responses":{"200":{"description":"Webhook listesi","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookList"}}}}},"description":"Kimliği doğrulanmış kullanıcıya ait webhook kayıtlarını döndürür."}}}}
```

## Webhook oluştur

> Yeni bir webhook kaydı oluşturur. Görev ve zaman takibi türlerinde \`group\` (proje) zorunludur. Bildirim alma kuralları \*\*Webhook\*\* bölümündedir.

```json
{"openapi":"3.0.3","info":{"title":"Cubicl API","version":"1.0.0"},"tags":[{"name":"Webhook","description":"Webhook'lar, Cubicl'ı diğer uygulamalarla entegre etmenizi sağlar. Seçtiğiniz işlem türü gerçekleştiğinde Cubicl, eklediğiniz webhook URL'sine bildirim gönderir.<br><br>• Müşteri oluşturulduğunda<br>• Müşteri güncellendiğinde<br>• Müşteri silindiğinde<br>• Görev oluşturulduğunda<br>• Görev güncellendiğinde<br>• Görev silindiğinde<br>• Göreve aktivite eklendiğinde<br>• Görev durumu değiştirildiğinde<br>• Görev arşivlendiğinde<br>• Görev arşivden geri yüklendiğinde<br>• Zaman takibi kaydı eklendiğinde<br>• Zaman takibi kaydı güncellendiğinde<br>• Zaman takibi kaydı silindiğinde<br>• Forma yanıt verildiğinde<br>• İzin günü talebi geldiğinde<br>• Hesaba giriş yapıldığında<br>• Yazışma mesajı alındığında<br>• Uygulama içi bildirim alındığında<br><br>Webhook arayüzden de eklenebilir: [Navigasyon Menüsü > Diğer > Entegrasyon](https://cubicl.io/integrations) > Webhook Ayarları.<br><br><h3>Kimler bildirim alır?</h3>• Görev ve zaman takibi türlerinde webhook'u bir projeyle ilişkilendirmeniz gerekir. Bildirim almak için o projedeki görevi görme yetkiniz olmalıdır.<br>• Proje seçilmeyen diğer türlerde ilgili sayfanın iznine bakılır. Müşteri olaylarında Müşteriler sayfasını görme yetkiniz, izin günü talebinde İzin Günleri sayfasını görme yetkiniz gerekir. Forma yanıtında webhook sahibi formun kurumunda olmalıdır.<br>• Hesaba giriş, uygulama içi bildirim ve yazışma mesajı doğrudan webhook'u ekleyen hesaba aittir; bu olaylar sizin hesabınızla ilgiliyse gönderilir.<br><br>Her POST gövdesinde kebab-case `type` alanı vardır (`task-created`, `form-submitted` gibi).<br><br>Olay gövdeleri **Modeller** bölümünde `Webhook*` şemaları olarak tanımlıdır."}],"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":{"WebhookWrite":{"type":"object","properties":{"group":{"type":"string","description":"Görev ve zaman takibi webhook türlerinde proje ID'si zorunludur. Bildirim almak için o projedeki görevi görme yetkiniz gerekir."},"type":{"allOf":[{"$ref":"#/components/schemas/WebhookType"}],"description":"Tetikleyici olay türü"},"url":{"type":"string","format":"uri","description":"Olay gövdelerinin gönderileceği URL. Geçerli ve bu olayları kabul edecek şekilde hazırlanmış olmalı."}}},"WebhookType":{"type":"string","enum":["customer-created","customer-updated","customer-deleted","task-created","task-updated","task-deleted","posted-on-task","task-state-changed","task-archived","task-restored","timer-created","timer-updated","timer-deleted","form-submitted","time-off-requested","user-logged-in","chat-message-received","notification-received"]},"Webhook":{"type":"object","properties":{"_id":{"type":"string"},"type":{"$ref":"#/components/schemas/WebhookType"},"url":{"type":"string"},"group":{"type":"string","description":"Proje ID'si"},"user":{"type":"string"},"createdAt":{"$ref":"#/components/schemas/UnixTimestamp"},"updatedAt":{"$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."}}},"ValidationError":{"type":"object","properties":{"message":{"type":"string"},"errors":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}}}}}}},"paths":{"/users/self/webhook":{"post":{"tags":["Webhook"],"summary":"Webhook oluştur","operationId":"createWebhook","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookWrite"}}}},"responses":{"200":{"description":"Yeni webhook","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Webhook"}}}},"422":{"description":"Geçersiz işlem","content":{"application/json":{"schema":{"oneOf":[{"$ref":"#/components/schemas/ErrorCode"},{"$ref":"#/components/schemas/ValidationError"}]}}}}},"description":"Yeni bir webhook kaydı oluşturur. Görev ve zaman takibi türlerinde `group` (proje) zorunludur. Bildirim alma kuralları **Webhook** bölümündedir."}}}}
```

## Webhook güncelle

> Belirtilen bilgilerle webhook kaydını günceller. Tüm alanlar isteğe bağlıdır. Yalnızca gönderilen alanlar güncellenir.

```json
{"openapi":"3.0.3","info":{"title":"Cubicl API","version":"1.0.0"},"tags":[{"name":"Webhook","description":"Webhook'lar, Cubicl'ı diğer uygulamalarla entegre etmenizi sağlar. Seçtiğiniz işlem türü gerçekleştiğinde Cubicl, eklediğiniz webhook URL'sine bildirim gönderir.<br><br>• Müşteri oluşturulduğunda<br>• Müşteri güncellendiğinde<br>• Müşteri silindiğinde<br>• Görev oluşturulduğunda<br>• Görev güncellendiğinde<br>• Görev silindiğinde<br>• Göreve aktivite eklendiğinde<br>• Görev durumu değiştirildiğinde<br>• Görev arşivlendiğinde<br>• Görev arşivden geri yüklendiğinde<br>• Zaman takibi kaydı eklendiğinde<br>• Zaman takibi kaydı güncellendiğinde<br>• Zaman takibi kaydı silindiğinde<br>• Forma yanıt verildiğinde<br>• İzin günü talebi geldiğinde<br>• Hesaba giriş yapıldığında<br>• Yazışma mesajı alındığında<br>• Uygulama içi bildirim alındığında<br><br>Webhook arayüzden de eklenebilir: [Navigasyon Menüsü > Diğer > Entegrasyon](https://cubicl.io/integrations) > Webhook Ayarları.<br><br><h3>Kimler bildirim alır?</h3>• Görev ve zaman takibi türlerinde webhook'u bir projeyle ilişkilendirmeniz gerekir. Bildirim almak için o projedeki görevi görme yetkiniz olmalıdır.<br>• Proje seçilmeyen diğer türlerde ilgili sayfanın iznine bakılır. Müşteri olaylarında Müşteriler sayfasını görme yetkiniz, izin günü talebinde İzin Günleri sayfasını görme yetkiniz gerekir. Forma yanıtında webhook sahibi formun kurumunda olmalıdır.<br>• Hesaba giriş, uygulama içi bildirim ve yazışma mesajı doğrudan webhook'u ekleyen hesaba aittir; bu olaylar sizin hesabınızla ilgiliyse gönderilir.<br><br>Her POST gövdesinde kebab-case `type` alanı vardır (`task-created`, `form-submitted` gibi).<br><br>Olay gövdeleri **Modeller** bölümünde `Webhook*` şemaları olarak tanımlıdır."}],"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"},"WebhookWrite":{"type":"object","properties":{"group":{"type":"string","description":"Görev ve zaman takibi webhook türlerinde proje ID'si zorunludur. Bildirim almak için o projedeki görevi görme yetkiniz gerekir."},"type":{"allOf":[{"$ref":"#/components/schemas/WebhookType"}],"description":"Tetikleyici olay türü"},"url":{"type":"string","format":"uri","description":"Olay gövdelerinin gönderileceği URL. Geçerli ve bu olayları kabul edecek şekilde hazırlanmış olmalı."}}},"WebhookType":{"type":"string","enum":["customer-created","customer-updated","customer-deleted","task-created","task-updated","task-deleted","posted-on-task","task-state-changed","task-archived","task-restored","timer-created","timer-updated","timer-deleted","form-submitted","time-off-requested","user-logged-in","chat-message-received","notification-received"]},"Webhook":{"type":"object","properties":{"_id":{"type":"string"},"type":{"$ref":"#/components/schemas/WebhookType"},"url":{"type":"string"},"group":{"type":"string","description":"Proje ID'si"},"user":{"type":"string"},"createdAt":{"$ref":"#/components/schemas/UnixTimestamp"},"updatedAt":{"$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."}}},"ValidationError":{"type":"object","properties":{"message":{"type":"string"},"errors":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}}}}}},"responses":{"NotFoundEmpty":{"description":"Kaynak bulunamadı"}}},"paths":{"/users/self/webhook/{id}":{"put":{"tags":["Webhook"],"summary":"Webhook güncelle","description":"Belirtilen bilgilerle webhook kaydını günceller. Tüm alanlar isteğe bağlıdır. Yalnızca gönderilen alanlar güncellenir.","operationId":"updateWebhook","parameters":[{"$ref":"#/components/parameters/IdPath"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookWrite"}}}},"responses":{"200":{"description":"Güncellenmiş webhook","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Webhook"}}}},"404":{"$ref":"#/components/responses/NotFoundEmpty"},"422":{"description":"Geçersiz işlem","content":{"application/json":{"schema":{"oneOf":[{"$ref":"#/components/schemas/ErrorCode"},{"$ref":"#/components/schemas/ValidationError"}]}}}}}}}}}
```

## Webhook sil

> Belirtilen kimliğe sahip webhook kaydını siler.

```json
{"openapi":"3.0.3","info":{"title":"Cubicl API","version":"1.0.0"},"tags":[{"name":"Webhook","description":"Webhook'lar, Cubicl'ı diğer uygulamalarla entegre etmenizi sağlar. Seçtiğiniz işlem türü gerçekleştiğinde Cubicl, eklediğiniz webhook URL'sine bildirim gönderir.<br><br>• Müşteri oluşturulduğunda<br>• Müşteri güncellendiğinde<br>• Müşteri silindiğinde<br>• Görev oluşturulduğunda<br>• Görev güncellendiğinde<br>• Görev silindiğinde<br>• Göreve aktivite eklendiğinde<br>• Görev durumu değiştirildiğinde<br>• Görev arşivlendiğinde<br>• Görev arşivden geri yüklendiğinde<br>• Zaman takibi kaydı eklendiğinde<br>• Zaman takibi kaydı güncellendiğinde<br>• Zaman takibi kaydı silindiğinde<br>• Forma yanıt verildiğinde<br>• İzin günü talebi geldiğinde<br>• Hesaba giriş yapıldığında<br>• Yazışma mesajı alındığında<br>• Uygulama içi bildirim alındığında<br><br>Webhook arayüzden de eklenebilir: [Navigasyon Menüsü > Diğer > Entegrasyon](https://cubicl.io/integrations) > Webhook Ayarları.<br><br><h3>Kimler bildirim alır?</h3>• Görev ve zaman takibi türlerinde webhook'u bir projeyle ilişkilendirmeniz gerekir. Bildirim almak için o projedeki görevi görme yetkiniz olmalıdır.<br>• Proje seçilmeyen diğer türlerde ilgili sayfanın iznine bakılır. Müşteri olaylarında Müşteriler sayfasını görme yetkiniz, izin günü talebinde İzin Günleri sayfasını görme yetkiniz gerekir. Forma yanıtında webhook sahibi formun kurumunda olmalıdır.<br>• Hesaba giriş, uygulama içi bildirim ve yazışma mesajı doğrudan webhook'u ekleyen hesaba aittir; bu olaylar sizin hesabınızla ilgiliyse gönderilir.<br><br>Her POST gövdesinde kebab-case `type` alanı vardır (`task-created`, `form-submitted` gibi).<br><br>Olay gövdeleri **Modeller** bölümünde `Webhook*` şemaları olarak tanımlıdır."}],"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"},"ValidationError":{"type":"object","properties":{"message":{"type":"string"},"errors":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}}}}}},"responses":{"NotFoundEmpty":{"description":"Kaynak bulunamadı"},"ValidationFailed":{"description":"Doğrulama başarısız","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ValidationError"}}}}}},"paths":{"/users/self/webhook/{id}":{"delete":{"tags":["Webhook"],"summary":"Webhook sil","operationId":"deleteWebhook","parameters":[{"$ref":"#/components/parameters/IdPath"}],"responses":{"200":{"description":"Boş yanıt"},"404":{"$ref":"#/components/responses/NotFoundEmpty"},"422":{"$ref":"#/components/responses/ValidationFailed"}},"description":"Belirtilen kimliğe sahip webhook kaydını siler."}}}}
```
