Quote Status Updates

quote.updated

Overview of the quote.updated webhook

When a quote.updated event is triggered, FastSpring sends a webhook payload containing details about the updated quote. This webhook fires only when a quote's status or content changes via the FastSpring app or API. Status changes include the following:

StatusDescription
Quote AcceptedMoves from open to pending payment when the prospect accepts the quote but payment has not yet been completed (e.g. invoice generated instead of clicking Pay Now.
Quote CanceledMoves from open or pending payment to canceled; the associated order is canceled in the FastSpring app.
Quote CompletedMoves from open to completed when the prospect accepts the quote and completes payment.
Quote ExpiredMoves from open to expired; after expiration you can create a new quote or extend the expiration date to complete the order.
Quote Modified via AppIndicates the quote was updated by a seller directly in the FastSpring app.
Quote Modified via APIIndicates the quote was updated by a seller using the Create a quote API endpoint.

This page provides:

  • A full sample payload showing a populated quote.updated webhook
  • A detailed table listing every payload property, including name, type, and description
  • Notes on when this webhook is triggered and which fields appear based on Webhook Expansion

Browse the table sections below or use the quick links to jump to a specific group of fields.

Tip: Not all fields are always included. Refer to the Payload properties table to understand when a field appears.

Webhook payload example (expansion enabled)

When a quote.updated event is triggered, the webhook sends the following JSON payload:

{
    "quote": "QUW6Z4TYTPOJDRTF5DJ7E2CVYAWA",
    "quoteName": "Quote for Company",
    "changed": 1751898709788,
    "changedInSeconds": 1751898709,
    "changedDisplay": "07/07/25",
    "changedTimeDisplay": "14:31:49 UTC",
    "type": "Assisted",
    "updatedBy": "[email protected]",
    "order": "YxMPvrxHTfiRNCl3XSCGTA",
    "order reference": "ABC123456-7891-01112",
    "order status": "COMPLETED",
    "invoiceUrl": "https://company.onfastspring.com/popup-defaultB2B/account/order/ABC123456-7891-01112/invoice/IVTBQUMZ7LKFHEFEO3ERBPZ7J2AQ",
    "Reason": "Quote Completed",
    "creator": "[email protected]",
    "quoteStatus": "COMPLETED",
    "language": "en",
    "quoteCurrency": "USD",
    "quoteUrl": "https://company.onfastspring.com/popup-defaultB2B/account/order/quote/QUW6Z4TYTPOJDRTF5DJ7E2CVYAWA",
    "live": true,
    "account": "abCdE1FGH2Hij3KLMnOpqR",
    "coupon": "TENOFF",
    "recipient": {
        "first": "Jane",
        "last": "Doe",
        "email": "[email protected]",
        "company": "ABC Company",
        "phone": "5555555555",
        "taxID": null
    },
    "address": {
        "addressLine1": "801 Garden St",
        "city": "Santa Barbara",
        "region": "California",
        "postalCode": "93101",
        "country": "US",
        "display": "801 Garden St, Santa Barbara, California, 93101, US"
    },
    "fulfillmentSetting": "ON PAYMENT",
    "notes": "This is a Note",
    "tags": {},
    "items": [
    {
        "product": "Furious Falcon",
        "quantity": 4,
        "display": "Furious Falcon",
        "subtotal": 15,
        "subtotalDisplay": "$15.0",
        "discount": "0",
        "discountDisplay": "$0"
    }
    ]
}

Navigate this webhook

The quote.updated webhook payload includes details about the completed quote, including quote metadata, related order information, timestamps, recipient details, and quoted items. Use the cards below to jump to a specific section of the property reference.

Payload properties

All fields below are included in the quote.updated webhook payload. Fields are grouped into logical categories for easier navigation.

NameTypeDescription
Quote details
quotestringUnique identifier for the quote
quoteNamestringDisplay name or label for the quote
typestringQuote type, such as Assisted or Self-Service
updatedBystringEmail of the user who last updated the quote
ReasonstringReason associated with this quote event, e.g., Quote Completed
creatorstringEmail address of the user who originally created the quote
quoteStatusstringCurrent status of the quote, e.g., COMPLETED
languagestringTwo-letter ISO language code used for the quote
quoteCurrencystringThree-letter ISO currency code of the quote
quoteUrlstringDirect URL to view the completed quote in checkout
livebooleanIndicates whether the quote was created in live or test mode
accountstringFastSpring account ID associated with the quote
couponstringApplied coupon code, if any
fulfillmentSettingstringSpecifies when fulfillment occurs, e.g., ON PAYMENT
notesstringInternal note text included with the quote
tagsobjectCustom tag metadata applied to the quote (usually empty by default)
Order details
orderstringUnique identifier of the order created from the quote
order referencestringCustomer-facing order reference string
order statusstringStatus of the generated order, e.g., COMPLETED
invoiceUrlstringDirect URL to view or download the related invoice
Timestamps
changednumberTimestamp of the last update in milliseconds
changedInSecondsnumberTimestamp of the last update in seconds
changedDisplaystringHuman-readable date of the last change
changedTimeDisplaystringHuman-readable time of the last change with timezone
Recipient object
recipient.firststringRecipient’s first name
recipient.laststringRecipient’s last name
recipient.emailstringEmail address of the recipient
recipient.companystringCompany name of the recipient
recipient.phonestringPhone number of the recipient
recipient.taxIDnullRecipient’s tax ID if available
Address object
address.addressLine1stringPrimary street address line
address.citystringCity
address.regionstringRegion or state
address.postalCodestringPostal or ZIP code
address.countrystringTwo-letter ISO country code
address.displaystringFormatted full address display
Items array
itemsarrayList of products included in the completed quote
items.productstringProduct name or identifier
items.quantitynumberQuantity of the quoted product
items.displaystringCustomer-facing product display name
items.subtotalnumberItem subtotal in transaction currency
items.subtotalDisplaystringFormatted display of item subtotal
items.discountstringDiscount amount applied to the item (numeric string)
items.discountDisplaystringFormatted display of the item discount