Webhooks · In the sandbox

Send a test notification

POST/api/v1/webhooklar/{webhook_id}/test/

Sends one test notification with a made-up DENEME company ("test": true in the body) and returns the result at once; not retried. If your endpoint does not answer 2xx: 502 webhook_teslim_hatasi.

Authentication

X-API-Keyheaderrequired
ulk_…
X-API-Secretheaderrequired
ulsk_…

Authentication →

Path parameters

webhook_idintegerrequired
Webhook id.

Response fields

200 Delivered. application/json

teslimTeslimrequired
- teslim_idstringrequired
  Same across retries (de-duplication).
- olaystringrequired
  Values: sirket.degisiklik, test
- testbooleanrequired
- kategorilerstring[]required
  Values: durum, adres, ortaklik, sermaye, yetkililer, unvan, esas_sozlesme, diger, kapandi
- durumstringrequired
  Values: bekliyor, basarili, hata, vazgecildi
- deneme_sayisiintegerrequired
- http_koduintegerrequirednullable
- hatastringrequirednullable
- olusturmastring (date-time)requirednullable
- son_denemestring (date-time)requirednullable

Error responses

403anahtar_gerekli.
404Not found or no access (bulunamadi).
502Your endpoint did not answer 2xx; teslim has details.
401Missing or invalid key (yetkisiz).
429Hourly rate limit exceeded (hiz_siniri); the Retry-After header gives the seconds until reset.
500Unexpected error (ic_hata, taraf ulawk); retry shortly.

Error responses → hata, detay, hata_ayrinti

import requests basliklar = {"X-API-Key": "ulk_DENEME_ANAHTARINIZ", "X-API-Secret": "ulsk_DENEME_GIZLI_ANAHTARINIZ"} yanit = requests.post("https://ulawk.com/api/v1/webhooklar/1/test/", headers=basliklar, timeout=30) veri = yanit.json() if not yanit.ok: # hata_ayrinti.tekrar_denenebilir ise Retry-After kadar bekleyip yeniden deneyin print(yanit.status_code, veri["hata_ayrinti"]) print(veri)

const yanit = await fetch("https://ulawk.com/api/v1/webhooklar/1/test/", { method: "POST", headers: { "X-API-Key": "ulk_DENEME_ANAHTARINIZ", "X-API-Secret": "ulsk_DENEME_GIZLI_ANAHTARINIZ" } }); const veri = await yanit.json(); if (!yanit.ok) console.error(yanit.status, veri.hata_ayrinti); console.log(veri);

<?php $ch = curl_init("https://ulawk.com/api/v1/webhooklar/1/test/"); curl_setopt_array($ch, [ CURLOPT_RETURNTRANSFER => true, CURLOPT_CUSTOMREQUEST => "POST", CURLOPT_HTTPHEADER => ["X-API-Key: ulk_DENEME_ANAHTARINIZ", "X-API-Secret: ulsk_DENEME_GIZLI_ANAHTARINIZ"], ]); $govde = curl_exec($ch); $kod = curl_getinfo($ch, CURLINFO_HTTP_CODE); curl_close($ch); $veri = json_decode($govde, true); var_dump($kod, $veri);

using var http = new HttpClient(); http.DefaultRequestHeaders.Add("X-API-Key", "ulk_DENEME_ANAHTARINIZ"); http.DefaultRequestHeaders.Add("X-API-Secret", "ulsk_DENEME_GIZLI_ANAHTARINIZ"); var istek = new HttpRequestMessage(new HttpMethod("POST"), "https://ulawk.com/api/v1/webhooklar/1/test/"); var yanit = await http.SendAsync(istek); var metin = await yanit.Content.ReadAsStringAsync(); Console.WriteLine($"{(int)yanit.StatusCode} {metin}");

{ "teslim": { "teslim_id": "msg_3f9c1a0b7d2e4c5f6a7b8c9d", "olay": "test", "test": true, "kategoriler": [ "durum", "yetkililer" ], "durum": "basarili", "deneme_sayisi": 1, "http_kodu": 200, "hata": null, "olusturma": "2026-10-16T00:00:00+00:00", "son_deneme": "2026-10-16T00:00:00+00:00" } }

{ "hata": "anahtar_gerekli", "detay": "Bu işlem için X-API-Key (ve X-API-Secret) başlığı gerekli; panelden de yapabilirsiniz.", "hata_ayrinti": { "kod": "anahtar_gerekli", "mesaj": "Bu işlem için X-API-Key (ve X-API-Secret) başlığı gerekli; panelden de yapabilirsiniz.", "taraf": "istemci", "kaynak": null, "tekrar_denenebilir": false, "tekrar_sn": null } }

{ "hata": "bulunamadi", "detay": "Şirket bulunamadı ya da erişim yetkiniz yok.", "hata_ayrinti": { "kod": "bulunamadi", "mesaj": "Şirket bulunamadı ya da erişim yetkiniz yok.", "taraf": "istemci", "kaynak": null, "tekrar_denenebilir": false, "tekrar_sn": null } }

Retry-After: 60 { "hata": "webhook_teslim_hatasi", "detay": "Test bildirimi teslim edilemedi: HTTP 500", "hata_ayrinti": { "kod": "webhook_teslim_hatasi", "mesaj": "Test bildirimi teslim edilemedi: HTTP 500", "taraf": "istemci", "kaynak": null, "tekrar_denenebilir": true, "tekrar_sn": 60 }, "teslim": { "teslim_id": "msg_3f9c1a0b7d2e4c5f6a7b8c9d", "olay": "test", "test": true, "kategoriler": [ "durum", "yetkililer" ], "durum": "vazgecildi", "deneme_sayisi": 1, "http_kodu": 500, "hata": "HTTP 500", "olusturma": "2026-10-16T00:00:00+00:00", "son_deneme": "2026-10-16T00:00:00+00:00" } }

{ "hata": "yetkisiz", "detay": "Geçerli X-API-Key başlığı gerekli (panel › API).", "hata_ayrinti": { "kod": "yetkisiz", "mesaj": "Geçerli X-API-Key başlığı gerekli (panel › API).", "taraf": "istemci", "kaynak": null, "tekrar_denenebilir": false, "tekrar_sn": null } }

Retry-After: 66 { "hata": "hiz_siniri", "detay": "Saatlik istek sınırı aşıldı (600). Bir sonraki saatte tekrar deneyin.", "hata_ayrinti": { "kod": "hiz_siniri", "mesaj": "Saatlik istek sınırı aşıldı (600). Bir sonraki saatte tekrar deneyin.", "taraf": "istemci", "kaynak": null, "tekrar_denenebilir": true, "tekrar_sn": 66 } }

Retry-After: 60 { "hata": "ic_hata", "detay": "Beklenmeyen bir hata oluştu; kısa süre sonra yeniden deneyin.", "hata_ayrinti": { "kod": "ic_hata", "mesaj": "Beklenmeyen bir hata oluştu; kısa süre sonra yeniden deneyin.", "taraf": "ulawk", "kaynak": null, "tekrar_denenebilir": true, "tekrar_sn": 60 } }

Send a test notification

#Authentication

#Path parameters

#Response fields

#Error responses

Authentication

Path parameters

Response fields

Error responses