A quote has been approved

A version of a quote has been approved. An order form is generated from it in the same transaction, so an order_form.created event follows. This is a premium feature.

postWebhookquote_approved

Headers

X-Lago-Signaturestring required

Example:AAECAwQFBgcICQoLDA0ODxAREhMUFRYXGBkaGxwdHh8=

Signature of the webhook payload. The format depends on X-Lago-Signature-Algorithm: hmac is the Base64 encoding of an HMAC-SHA256 digest of the payload, jwt is an RS256 JSON Web Token (a string starting with eyJ).

X-Lago-Signature-Algorithm'jwt' | 'hmac' required

Example:hmac

Algorithm used to generate the signature

X-Lago-Unique-Keystring uuid required

Example:1a901a90-1a90-1a90-1a90-1a901a901a90

Unique id of the webhook. It can be used for idempotency

Payload

webhook_type'quote.approved' required

object_type'quote' required

organization_idstring uuid required

Unique identifier of the organization, created by Lago.

Example payload

{
  "organization_id": "1a901a90-1a90-1a90-1a90-1a901a901a90",
  "quote": {
    "lago_id": "1a901a90-1a90-1a90-1a90-1a901a901a90",
    "number": "QT-2026-0001",
    "order_type": "subscription_creation",
    "lago_customer_id": "1a901a90-1a90-1a90-1a90-1a901a901a90",
    "lago_subscription_id": "1a901a90-1a90-1a90-1a90-1a901a901a90",
    "lago_organization_id": "1a901a90-1a90-1a90-1a90-1a901a901a90",
    "created_at": "2026-04-29T08:59:51Z",
    "updated_at": "2026-04-29T08:59:51Z",
    "version": {
      "lago_id": "1a901a90-1a90-1a90-1a90-1a901a901a90",
      "lago_quote_id": "1a901a90-1a90-1a90-1a90-1a901a901a90",
      "lago_organization_id": "1a901a90-1a90-1a90-1a90-1a901a901a90",
      "version": 1,
      "status": "draft",
      "currency": "USD",
      "billing_entity_code": "acme_corp",
      "void_reason": "manual",
      "approved_at": "2026-04-29T08:59:51Z",
      "voided_at": "2026-04-29T08:59:51Z",
      "created_at": "2026-04-29T08:59:51Z",
      "updated_at": "2026-04-29T08:59:51Z"
    }
  }
}

Response

Return a 200 status to indicate that the data was received successfully

Changes

Webhooks have no change history: a webhook is keyed by its event name rather than a path and method, so no recorded change can name it.