Перейти до вмісту
Sursa Developers

Події · Люди й доступ

app.authorized

Застосунок авторизовано

Працівник авторизував застосунок OAuth або надав йому додаткові області доступу (data.app: id, name; data.authorization_id, data.user_id, data.scopes).

Тип об’єкта
app
Кому доставляється
Вебхукам із роллю адміністратора

Вміст події

Об’єкт: EventAppAuthorized

  • idstringобов’язково

    ID події (evt_…), також надсилається в заголовку webhook-id. За ним відкидайте дублікати доставок.

  • typestringобов’язково

    Допустимі значення: app.authorized

  • created_atstring (date-time)обов’язково

    Коли сталася зміна (UTC).

  • org_idintegerобов’язково
  • api_versionstringобов’язково

    Версія договору для схеми data.

  • sequenceinteger

    Порядковий номер доставки в межах вебхука (немає для тестової події).

  • objectWebhookEventObjectобов’язково
  • payloadstringобов’язково

    thin означає, що data немає: читайте об’єкт через API.

    Допустимі значення: fullthin

  • dataobject
    Поля
    • appobjectобов’язково

      Застосунок: ID і назва.

      Поля
      • idstring
      • namestring
    • authorization_idintegerобов’язково

      Авторизація працівника.

    • user_idintegerобов’язково

      Працівник, який авторизував застосунок.

    • scopesarray of stringобов’язково

      Області доступу авторизації.

  • testbooleanобов’язково

    Тестова подія, надіслана через POST /v1/webhooks/{webhook_id}/test.

Приклад доставки

{
  "id": "evt_0123456789abcdef0123456789abcdef",
  "type": "app.authorized",
  "created_at": "2026-10-24T10:00:03Z",
  "org_id": 1,
  "api_version": "1.62.0",
  "sequence": 1042,
  "object": {
    "type": "app",
    "id": "app_8f14e45fceea167a5a36dedd4bea2543"
  },
  "payload": "full",
  "data": {
    "app": {
      "id": "app_8f14e45fceea167a5a36dedd4bea2543",
      "name": "CRM sync"
    },
    "authorization_id": 12,
    "user_id": 7,
    "scopes": [
      "cards:read",
      "search"
    ]
  },
  "test": false
}

Отримання подій

Кожна доставка — це запит POST із таким тілом JSON на адресу вашого вебхука. Перш ніж довіряти тілу, перевірте заголовок webhook-signature (Standard Webhooks), відповідайте статусом 2xx протягом кількох секунд, а саму роботу виконуйте вже після відповіді. Доставки на один вебхук зберігають порядок подій; невдала доставка повторюється зі зростаючими паузами.

Нові типи подій і нові поля можуть з’явитися будь-коли: пропускайте типи й поля, яких ви не знаєте.

Ті самі події 30 днів зберігаються в стрічці подій →