quote.updated
Overview of the quote.updated webhook
quote.updated webhookWhen 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:
| Status | Description |
|---|---|
| Quote Accepted | Moves 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 Canceled | Moves from open or pending payment to canceled; the associated order is canceled in the FastSpring app. |
| Quote Completed | Moves from open to completed when the prospect accepts the quote and completes payment. |
| Quote Expired | Moves from open to expired; after expiration you can create a new quote or extend the expiration date to complete the order. |
| Quote Modified via App | Indicates the quote was updated by a seller directly in the FastSpring app. |
| Quote Modified via API | Indicates 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.updatedwebhook - 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.
| Name | Type | Description |
|---|---|---|
| Quote details | ||
| quote | string | Unique identifier for the quote |
| quoteName | string | Display name or label for the quote |
| type | string | Quote type, such as Assisted or Self-Service |
| updatedBy | string | Email of the user who last updated the quote |
| Reason | string | Reason associated with this quote event, e.g., Quote Completed |
| creator | string | Email address of the user who originally created the quote |
| quoteStatus | string | Current status of the quote, e.g., COMPLETED |
| language | string | Two-letter ISO language code used for the quote |
| quoteCurrency | string | Three-letter ISO currency code of the quote |
| quoteUrl | string | Direct URL to view the completed quote in checkout |
| live | boolean | Indicates whether the quote was created in live or test mode |
| account | string | FastSpring account ID associated with the quote |
| coupon | string | Applied coupon code, if any |
| fulfillmentSetting | string | Specifies when fulfillment occurs, e.g., ON PAYMENT |
| notes | string | Internal note text included with the quote |
| tags | object | Custom tag metadata applied to the quote (usually empty by default) |
| Order details | ||
| order | string | Unique identifier of the order created from the quote |
| order reference | string | Customer-facing order reference string |
| order status | string | Status of the generated order, e.g., COMPLETED |
| invoiceUrl | string | Direct URL to view or download the related invoice |
| Timestamps | ||
| changed | number | Timestamp of the last update in milliseconds |
| changedInSeconds | number | Timestamp of the last update in seconds |
| changedDisplay | string | Human-readable date of the last change |
| changedTimeDisplay | string | Human-readable time of the last change with timezone |
| Recipient object | ||
| recipient.first | string | Recipient’s first name |
| recipient.last | string | Recipient’s last name |
| recipient.email | string | Email address of the recipient |
| recipient.company | string | Company name of the recipient |
| recipient.phone | string | Phone number of the recipient |
| recipient.taxID | null | Recipient’s tax ID if available |
| Address object | ||
| address.addressLine1 | string | Primary street address line |
| address.city | string | City |
| address.region | string | Region or state |
| address.postalCode | string | Postal or ZIP code |
| address.country | string | Two-letter ISO country code |
| address.display | string | Formatted full address display |
| Items array | ||
| items | array | List of products included in the completed quote |
| items.product | string | Product name or identifier |
| items.quantity | number | Quantity of the quoted product |
| items.display | string | Customer-facing product display name |
| items.subtotal | number | Item subtotal in transaction currency |
| items.subtotalDisplay | string | Formatted display of item subtotal |
| items.discount | string | Discount amount applied to the item (numeric string) |
| items.discountDisplay | string | Formatted display of the item discount |