Webhook: Installation lifecycle

POSThttps://app.example.com/webhooks/tica

This page describes the delivery contract sent to your HTTPS receiver for the selected event group.

Events

installation.enabled, installation.updated, installation.revoked

Verification and retries

Verify the unmodified raw body with X-Tica-Timestamp and X-Tica-Signature using HMAC-SHA256. Persist delivery_id idempotently and return 2xx after queueing work.

INCOMING WEBHOOK DATA

Sample JSON body delivered to your application's HTTPS receiver.

APPLICATION/JSON

{
  "delivery_id": "delivery_01J4...",
  "event_name": "installation.enabled",
  "schema_version": 1,
  "installation_id": "install_01J4...",
  "domain_id": 42,
  "aggregate_type": "installation",
  "aggregate_id": "resource_...",
  "aggregate_version": 12,
  "occurred_at": "2026-08-10T16:00:00Z",
  "payload": {
    "status": "enabled",
    "approved_scopes": [
      "orders.read"
    ],
    "approved_events": [
      "order.created"
    ],
    "changed_fields": [
      "status"
    ]
  }
}