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.

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.requestedAn agent or API key call is held until a person approves it. Carries the action and a link to approve or reject it.
dispute.openedA dispute was opened against a payment. Carries the amount, currency and reason.
price_proposal.createdThe commerce control plane proposed a price change. Carries the current and proposed price.
rosetta.adapter.review_requiredA new data adapter needs a review before it is used. Its frozen, resolved and drift events follow the same adapter.
webhooks.failingOne of your endpoints keeps failing. Sent to your other healthy endpoints, never to the failing one.
platform.changelogA 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.lowA 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_recordedYou reported whether a price was used. With outcome pricing on, says what was refunded.
outcome.settledAn outcome pricing window was decided: by your report, or as accepted when it closed with none.
learned_elasticity.changedA 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
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- 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.
- 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.
- 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.
- 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.
- 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.