appazon

Integrations

Webhooks

Receive HTTP callbacks when builds are ready or install thresholds are hit.

Webhooks are available on Developer Pro plans. Configure them per app in the console under the Webhooks tab.

Events

  • build.ready — fired when a build upload completes and is ready to install
  • install.threshold — fired when install count crosses a configured threshold

Payload

POST https://your-server.com/hooks/appdist
Content-Type: application/json
X-Appdist-Event: build.ready
X-Appdist-Signature: sha256=<hmac_hex>

{
  "event": "build.ready",
  "app_id": "uuid",
  "delivered_at": "2026-07-05T12:00:00.000Z",
  "data": {
    "build_id": "uuid",
    "version": "1.4.2",
    "share_url": "https://appazon.store/i/aB3xY9"
  }
}

Verify signature

Compute HMAC-SHA256 of the raw JSON body using your webhook secret. Compare to the X-Appdist-Signature header (strip the sha256= prefix).

const crypto = require("crypto");
const expected = crypto
  .createHmac("sha256", WEBHOOK_SECRET)
  .update(rawBody)
  .digest("hex");
const received = req.headers["x-appdist-signature"]?.replace("sha256=", "");
if (expected !== received) throw new Error("Invalid signature");