Guides and Examples
...
Revenue Lifecycle Management
Update Objects
28 min
the update objects api allows you to update existing records in salesforce through nue's revenue lifecycle api this endpoint provides partial updates (patch) to various business objects required permission your api key must be associated with a role that has manage salesforce orders and/or manage quotes permission enabled under the "nue on salesforce" category endpoint patch /api/objects/{objectname}/{id} supported objects object description customer update customer accounts (maps to salesforce account) opportunity update sales opportunities including stage, dates, and amounts quote update quote records including discounts, dates, and status quotelineitem update quote line items order update order records and status orderproduct update order line items important metadata driven fields the fields available for each object are determined by your salesforce metadata configuration and permissions the fields documented below are common examples and may vary based on your organization's setup to see the exact fields available for your environment use the /docs/api references/metadata api to retrieve object definitions check your salesforce org's field configurations some fields may be read only or have update restrictions based on your permissions authentication include your api key in the request header curl x patch 'https //api nue io/api/objects/quote/0q0em000006xbgdkay' \\ h 'nue api key your api key' \\ h 'content type application/json' update customer update an existing customer account request curl x patch 'https //api nue io/api/objects/customer/001d000000irfmaiah' \\ h 'nue api key your api key' \\ h 'content type application/json' \\ d '{ "phone" "+1 555 9876", "billingstreet" "456 new street", "billingcity" "los angeles", "billingstate" "ca" }' updatable customer fields (examples) the following fields are commonly updatable your actual fields depend on your metadata configuration and permissions field type description name string account name email string primary contact email phone string phone number industry string industry classification billingstreet string billing street address billingcity string billing city billingstate string billing state/province billingpostalcode string billing postal code billingcountry string billing country shippingstreet string shipping street address shippingcity string shipping city shippingstate string shipping state/province shippingpostalcode string shipping postal code shippingcountry string shipping country billcycleday string day of month for billing cycle paymentterm string payment terms paymentmethod string default payment method description string account description update opportunity update an existing sales opportunity request curl x patch 'https //api nue io/api/objects/opportunity/006d000000iqhsliaz' \\ h 'nue api key your api key' \\ h 'content type application/json' \\ d '{ "stage" "negotiation", "probability" 75, "description" "updated opportunity details" }' update opportunity stage and close date curl x patch 'https //api nue io/api/objects/opportunity/006d000000iqhsliaz' \\ h 'nue api key your api key' \\ h 'content type application/json' \\ d '{ "stage" "closed won", "closedate" "2025 03 15", "probability" 100 }' update opportunity subscription dates curl x patch 'https //api nue io/api/objects/opportunity/006d000000iqhsliaz' \\ h 'nue api key your api key' \\ h 'content type application/json' \\ d '{ "subscriptionstartdate" "2025 04 01", "subscriptionenddate" "2026 03 31", "subscriptionterm" 12 }' updatable opportunity fields (examples) the following fields are commonly updatable your actual fields depend on your metadata configuration and permissions field type description name string opportunity name stage string current opportunity stage (e g , "prospecting", "negotiation", "closed won") closedate date expected close date accountid string customer account id probability number confidence percentage (0 100) description string text description of the opportunity nextstep string next step in the sales process discountamount number total discretional discount amount discountpercentage number discretional discount percentage subscriptionstartdate date start date for products or services subscriptionenddate date end date for products or services subscriptionterm number length of the subscription primaryquoteid string id of the primary quote for this opportunity response a successful update returns http 200 with an empty body update quote update an existing quote record request curl x patch 'https //api nue io/api/objects/quote/0q0em000006xbgdkay' \\ h 'nue api key your api key' \\ h 'content type application/json' \\ d '{ "name" "enterprise edition 100 licenses", "description" "updated for renewal", "status" "approved", "expirationdate" "2025 12 31" }' update quote dates when updating subscriptionstartdate , the quote's end date and applicable line item dates will be shifted accordingly curl x patch 'https //api nue io/api/objects/quote/0q0em000006xbgdkay' \\ h 'nue api key your api key' \\ h 'content type application/json' \\ d '{ "subscriptionstartdate" "2025 06 01" }' update primary quote status toggle whether a quote is the primary quote for an opportunity this will synchronize or remove line items on the associated opportunity curl x patch 'https //api nue io/api/objects/quote/0q0em000006xbgdkay' \\ h 'nue api key your api key' \\ h 'content type application/json' \\ d '{ "isprimaryquote" true }' updatable quote fields (examples) the following fields are commonly updatable your actual fields depend on your metadata configuration and permissions field type description name string quote name description string quote description status string quote status (e g , "draft", "approved") expirationdate date quote expiration date subscriptionstartdate date subscription start date subscriptionenddate date subscription end date subscriptionterm number subscription term length subscriptiontermdimension string term unit (e g , "month", "year") isprimaryquote boolean whether this is the primary quote istemplatequote boolean whether this is a template quote opportunityid string associated opportunity id contactid string contact id billingaccountid string billing account id email string email address phone string phone number paymentmethod string payment method paymentmethods string available payment methods paymentterm string payment terms autorenew boolean auto renewal flag billingname string billing recipient name billingstreet string billing street address billingcity string billing city billingstate string billing state/province billingpostalcode string billing postal code billingcountry string billing country shippingname string shipping recipient name shippingstreet string shipping street address shippingcity string shipping city shippingstate string shipping state/province shippingpostalcode string shipping postal code shippingcountry string shipping country response a successful update returns http 200 with an empty body update quote line item update an existing quote line item request curl x patch 'https //api nue io/api/objects/quotelineitem/0qlem000001ojaroaa' \\ h 'nue api key your api key' \\ h 'content type application/json' \\ d '{ "quantity" 10, "discount" 15, "description" "updated line item" }' updatable quote line item fields (examples) the following fields are commonly updatable your actual fields depend on your metadata configuration and permissions field type description quantity number line item quantity discount number discount percentage discountamount number discount amount description string line item description listprice number list price per unit unitprice number sales price per unit subscriptionstartdate date subscription start date subscriptionenddate date subscription end date subscriptionterm number subscription term autorenew boolean auto renewal flag billingperiod string billing period billingtiming string billing timing paymentterm string payment terms response a successful update returns http 200 with an empty body update order update an existing order, such as changing its status activate an order curl x patch 'https //api nue io/api/objects/order/801em000011n4dnias' \\ h 'nue api key your api key' \\ h 'content type application/json' \\ d '{ "status" "activated" }' update order fields curl x patch 'https //api nue io/api/objects/order/801em000011n4dnias' \\ h 'nue api key your api key' \\ h 'content type application/json' \\ d '{ "description" "updated order description", "ponumber" "po 2025 001", "podate" "2025 01 15" }' updatable order fields (examples) the following fields are commonly updatable your actual fields depend on your metadata configuration and permissions field type description status string order status (e g , "draft", "activated") description string order description ponumber string purchase order number podate date purchase order date response a successful update returns http 200 with an empty body update order product update an existing order line item request curl x patch 'https //api nue io/api/objects/orderproduct/802d000000iz4abcd' \\ h 'nue api key your api key' \\ h 'content type application/json' \\ d '{ "quantity" 15, "description" "updated quantity" }' updatable order product fields (examples) the following fields are commonly updatable your actual fields depend on your metadata configuration and permissions field type description quantity number line item quantity discount number discount percentage discountamount number discount amount description string line item description subscriptionstartdate date subscription start date subscriptionenddate date subscription end date subscriptionterm number subscription term response a successful update returns http 200 with an empty body