Вебхуки

Формат доставки

На каждое событие База отправляет один POST на зарегистрированный URL.

#Заголовки

http

X-Bazabaza-Event: record.updated
X-Bazabaza-Signature: sha256=<hmac>
Content-Type: application/json

#Тело запроса

json

{
  "event": "record.updated",
  "workspaceId": "9e…workspace-uuid",
  "data": {
    "id": "9e…record-uuid",
    "collectionId": "9e…collection-uuid",
    "title": "Поставка на 250 000 ₽",
    "stageId": "9e…stage-uuid",
    "values": { "9e…field-uuid": "Ромашка" },
    "createdAt": "…",
    "updatedAt": "…"
  },
  "at": "2026-09-13T11:00:00+00:00"
}

#Что в data

Для событий из публичного API — полная запись в формате v1 (как в GET /api/v1/records/{id}).
Для событий из приложения — краткий объект: id, collectionId, title; при изменении добавляются stageId и values.
Идентификаторы всегда строки; values — объект по идентификаторам полей.

Значение в data.values — состояние после обработки события (для record.deleted — последний известный снимок записи).