Collapse Menu
Documentation
FastSpring App
Developer Tools
Contact Support

PUT /quotes{id} - Update a Quote

Overview

How to update a quote using the PUT /quote API response, and the corresponding responses

The PUT /quotes/{id} endpoint updates an existing quote with the attributes you provide in the request. You must include all attributes in the request, otherwise they will either be cleared or reset to default values.

You can only update a quote with the Open status.

Required Attributes

AttributeTypeDescriptionConstraint
couponstringA coupon code for the quote. (This is not a coupon ID)If a coupon is present, items will be updated as necessary. 

If the coupon is blank, null, or missing from the request, any previous coupon will be removed. 
currencystringThe three-letter ISO code of the currency of the quoteIf the currency is updated, items will be updated as necessary. 
expirationDateDaysnumberNumber of days after quote creation that it expiresThis will update the expires and expiresDisplay attributes. 
fulfillmentTermstringThe fulfillment term for the quote 
itemsstringThe items included in the quote 
namestringA descriptive name for the quote 
notesstringProspect-facing notes that will appear on the quote 
netTermDaysintegerThe net terms days for the quote. 
When value is 0, payment is required immediately, prior to order acceptance.
Must be one of: 0, 1, 7, 14, 30, 45, 60, 90
recipientcontactThe quote recipient’s contact information, including: email address, first name, last name 
recipientAddressaddressThe recipient’s address information, including: city, country, postal code, and regionIf the country attribute of recipientAddress is updated, items will be updated as necessary. 

If the postalCode attribute of recipientAddress is updated items will be updated as necessary.
tagsobjectKey-value pairs for your internal tracking. Tags are invisible to your prospect. FastSpring does not utilize your tags 
taxIdstringA tax ID for the quoteIf a taxId is present, items will be updated as necessary. 

If the taxId is blank, null, or missing from the request, any previous taxId will be removed and items will be updated as necessary. 

UpdateQuote Responses

Successful Responses:

  • 200 OK: A single quote is returned

Error Responses:

  • 404 Not Found: Returned when the quote ID is not found. See the ErrorResponse for more information about which product path is invalid. 
    Check the Error Response Details for more information about which products are invalid.
  • 500 Server Error: Something went wrong on FastSpring’s side. See ErrorResponse for more details.

Example: Update the Name

The example below updates quote with the ID number QU123XYZABC456DEF789GHI0123Q to fix a typo in the recipient’s last name.

  • {
       "coupon": "5OFF", 
       "currency": "USD",
       "expirationDateDays": 30, 
       fulfillmentTerm: "ON_PAYMENT",
       "items": [ 
         {
           "path": "sample-product-from-catalog"
         }
       ],
       "name": "Example json of a Quote Resource object",
       "notes": "Here are some notes for this quote.",
       "netTermsDays": 30,
       "recipient": {
         "email": "example@examplecompany.com",
         "first": "Update",
         "last": "Customer",
         "company": "ExampleCompany",
         "phone": "(805)123-4567" 
       },
       "recipientAddress": {
         "city": "Santa Barbara",
         "country": "US",
         "postalCode": "93101",
         "region": "CA",
         "streetLine1": "801 Garden Street",
         "streetLine2": "Ste. 201"
       },
       "taxId": null
    }