Skip to content
Developers

Webhooks · In the sandbox

Create a webhook

POST/api/v1/webhooklar/

Creates a change webhook. https only; addresses resolving to private or local networks are rejected. Up to 5 addresses. Empty kategoriler = all categories. The gizli signing secret is shown only in this response. API key only (session cookies are not accepted).

Authentication

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

Authentication →

Request body application/json

  • urlstring (uri)required
    https URL (max 500 characters).
  • kategorilerstring[]optional
    Subscribed categories. Values: durum, adres, ortaklik, sermaye, yetkililer, unvan, esas_sozlesme, diger, kapandi

Response fields

201 Webhook and its secret. application/json

  • idintegerrequired
  • urlstring (uri)required
  • aktifbooleanrequired
  • kategorilerstring[]required
    Empty = all categories. Values: durum, adres, ortaklik, sermaye, yetkililer, unvan, esas_sozlesme, diger, kapandi
  • tum_kategorilerbooleanrequired
  • olusturmastring (date-time)requirednullable
  • son_gonderimstring (date-time)requirednullable
  • son_durumstringrequirednullable
  • ardisik_hataintegerrequired
    Consecutive failures; paused at 20.
  • son_teslimlerTeslim[]optional
    Only in webhook detail (last 20).
    • 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
  • gizlistringrequired
    Signing secret (whsec_…): shown ONLY in this response.
  • aciklamastringrequired

Error responses

  • 400gecersiz_json or gecersiz_webhook (address, category, limit).
  • 403API key required (anahtar_gerekli).
  • 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

Markdown · OpenAPI · llms.txt · © 2026 Ulawk