Skip to content
TR Open panel
Webhooks

Webhooks

A webhook is a POST request Bulutegra sends to your endpoint when an event happens, so you don't have to keep polling the API for new orders.

Adding a webhook

  1. Under Settings › Bulutegra API and webhooks › Webhooks enter your URL (https:// only).
  2. Pick the events you want and press Add webhook.
  3. Save the signing secret (whsec_…) shown; it is displayed only once.
  4. Use Send test to deliver a test event and verify the connection.

Request

POST /bulutegra-webhook HTTP/1.1
Content-Type: application/json; charset=utf-8
User-Agent: Bulutegra-Webhook/1
X-Bulutegra-Olay: siparis.yeni
X-Bulutegra-Teslim: siparis_yeni_3f9c1a7e2b6d4c10
X-Bulutegra-Imza: sha256=5d2c…
{
  "olay": "siparis.yeni",
  "kimlik": "siparis_yeni_3f9c1a7e2b6d4c10",
  "zaman": "2026-10-07 10:45:00",
  "veri": {
    "kanal": "trendyol",
    "kanal_ad": "Trendyol",
    "siparis_no": "10000000001",
    "belge": "20000000001",
    "tarih": "2026-10-07 10:42:11",
    "durum": "Picking",
    "durum_kategori": "bekliyor",
    "tutar": 849.9,
    "para_birimi": "TRY",
    "adet": 2,
    "kalemler": [
      {
        "sku": "ABC-1001|SIYAH|M|",
        "barkod": "8680000000017",
        "adet": 2,
        "ad": "Örnek Ürün — Pamuklu Tişört, M"
      }
    ],
    "erp": {
      "yonetim": "bulutegra",
      "aktarildi": true,
      "erp_no": "1-S-1-000123"
    },
    "ilk_gorulme": "2026-10-07 10:43:02",
    "son_kontrol": "2026-10-07 11:20:45"
  }
}
FieldDescription
olayEvent name — see Events
kimlikDelivery id; stays the same when an event is retried — use it to de-duplicate
zamanWhen the event was generated
veriThe order object (fields); webhooks never include the customer name

Your response

Return a 2xx within 10 seconds of receiving the request; queue heavy work and respond immediately. The response body is ignored. Redirects (3xx) are not followed.

Last updated: 2026-10-07