Skip to content

Webhooks

Subscribe to every metering and settlement event.

Last Price emits HMAC-SHA256 signed webhooks for every meaningful platform event. Verify the x-lastprice-signature header against the raw body and you can trust the payload end-to-end.

last-price.ai/webhooks
last-price.ai/webhooks
Webhook destinations and per-endpoint delivery logs.

What you can do

  • Subscribe any HTTPS endpoint with a per-destination signing secret.
  • Verify each request with HMAC-SHA256 over the raw body, header is x-lastprice-signature (the older x-paid-signature carries the same value).
  • Filter by event type, function, or tenant when you only care about a subset.
  • Inspect every delivery: request body, response status, retries, and timing.
  • Automatic retry with exponential backoff on 5xx and network errors.

Event types

  • approval.requested

    An agent or API key call is held until a person approves it. Carries the action and a link to approve or reject it.

  • dispute.opened

    A dispute was opened against a payment. Carries the amount, currency and reason.

  • price_proposal.created

    The commerce control plane proposed a price change. Carries the current and proposed price.

  • rosetta.adapter.review_required

    A new data adapter needs a review before it is used. Its frozen, resolved and drift events follow the same adapter.

  • webhooks.failing

    One of your endpoints keeps failing. Sent to your other healthy endpoints, never to the failing one.

  • platform.changelog

    A changelog entry for agents was published. Carries the new entries and the feed address. Sent only to endpoints that subscribe to it by name.

  • balance.low

    A compute call took the prepaid balance below the auto top-up threshold you set. Carries the balance and the top-up request. Nothing is charged.

  • usage.outcome_recorded

    You reported whether a price was used. With outcome pricing on, says what was refunded.

  • outcome.settled

    An outcome pricing window was decided: by your report, or as accepted when it closed with none.

  • learned_elasticity.changed

    A learned pricing estimate changed a price, or a change is waiting for your approval. Carries the old and new price at an example price.

Verify a delivery

Node.js
import crypto from "node:crypto"

export function verifyWebhook(rawBody: string, header: string, secret: string) {
  const expected = crypto
    .createHmac("sha256", secret)
    .update(rawBody)
    .digest("hex")
  // Constant-time compare to avoid timing leaks.
  const a = Buffer.from(expected, "hex")
  const b = Buffer.from(header, "hex")
  return a.length === b.length && crypto.timingSafeEqual(a, b)
}

// In your route handler:
const ok = verifyWebhook(rawBody, req.headers["x-lastprice-signature"], process.env.WEBHOOK_SECRET)

The signature is HMAC-SHA256 over the raw request body, not the parsed JSON, and no timestamp. Use a constant-time compare to avoid timing attacks. The server signs every delivery with this same check.

Recent changes

All Webhooks notes
  1. Improved

    Settings, Integrations shows everything you can connect

    Integrations now lists what this workspace can connect, with what is connected already: Shopify, Amazon and UCP stores, webhooks, your Anthropic key, and the MCP address to paste into Claude, ChatGPT or Cursor.

  2. Fixed

    Billing changes need billing access, and webhooks need public HTTPS

    Changing billing mode needs billing:write, plans can no longer be changed through the workspace update route, and webhook URLs must be public HTTPS addresses.

  3. Fixed

    Rotate webhook signing secrets, and tokens end with their key

    Webhook signing secrets have their own rotate route, and a token stops working when the key it came from is revoked or rotated.

  4. New

    Email alerts once a day, without the ones already handled

    Choose "Once a day" for any email alert to get one summary at 8:00 in your time zone instead of an email each time. Alerts about an approval already decided, a dispute already closed or an endpoint that recovered are left out of retries and summaries.

  5. New

    Email alerts for approvals, disputes and failing webhooks

    Owners and admins now get an email when a call is held for approval, a dispute opens, or a webhook endpoint keeps failing, and choose which ones in their profile. Agents get the same alerts through the notifications feed, MCP, webhooks and their own inbox.

Ready to try it?

Spin up a free playground tenant in under a minute. No credit card.