Guides and Examples
...
Revenue Lifecycle Management
Delete Objects
23 min
the delete objects api allows you to delete existing records in salesforce through nue's revenue lifecycle api this endpoint supports both single and bulk deletions 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 delete /api/objects/{objectname}/{id} supported objects object description customer delete customer accounts (maps to salesforce account) opportunity delete sales opportunities quote delete quote records quotelineitem delete quote line items order delete order records orderproduct delete order line items important deletion constraints some objects have restrictions on when they can be deleted published products cannot be deleted (status must not be "published" or "outdated") objects with dependent records may require those records to be deleted first deletion permissions depend on your salesforce org's field level security and sharing rules authentication include your api key in the request header curl x delete 'https //api nue io/api/objects/customer/001d000000irfmaiah' \\ h 'nue api key your api key' delete customer delete an existing customer account request curl x delete 'https //api nue io/api/objects/customer/001d000000irfmaiah' \\ h 'nue api key your api key' response a successful deletion returns http 200 with an empty body delete opportunity delete an existing sales opportunity request curl x delete 'https //api nue io/api/objects/opportunity/006d000000iqhsliaz' \\ h 'nue api key your api key' response a successful deletion returns http 200 with an empty body delete quote delete an existing quote record request curl x delete 'https //api nue io/api/objects/quote/0q0em000006xbgdkay' \\ h 'nue api key your api key' response a successful deletion returns http 200 with an empty body delete quote line item delete an existing quote line item request curl x delete 'https //api nue io/api/objects/quotelineitem/0qlem000001ojaroaa' \\ h 'nue api key your api key' response a successful deletion returns http 200 with an empty body delete order delete an existing order record request curl x delete 'https //api nue io/api/objects/order/801em000011n4dnias' \\ h 'nue api key your api key' response a successful deletion returns http 200 with an empty body delete order product delete an existing order line item request curl x delete 'https //api nue io/api/objects/orderproduct/802d000000iz4abcd' \\ h 'nue api key your api key' response a successful deletion returns http 200 with an empty body bulk delete delete multiple records of the same object type in a single request endpoint delete /api/objects/{objectname}list request curl x delete 'https //api nue io/api/objects/customerlist' \\ h 'nue api key your api key' \\ h 'content type application/json' \\ d '{ "idlist" \[ "001d000000irfmaiah", "001d000000irfmbiah", "001d000000irfmciah" ] }' request body field type required description idlist array yes array of salesforce record ids to delete response a successful bulk deletion returns http 200 with an empty body error handling common error responses status code error description 400 bad request invalid request format or missing required id 401 unauthorized invalid or missing api key 403 forbidden insufficient permissions or object type not accessible 404 not found record not found with the specified id 409 conflict record cannot be deleted due to constraints example error response { "title" "oops! an error occurred", "message" "provided external id field does not exist or is not accessible invalid id here", "errorcode" "not found" }