---
sourceDocument: Brazil Sales Customer Relationship Management
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/order-management

 Release :

    - brazil

ft:locale :

    - en-US

ft:publication_title :

    - Brazil Sales Customer Relationship Management

ft:clusterId :

    - omgmt

bundleId :

    - omgmt

workflow :

    - Customer and Industry


---

# The CPQ Reconfigure API

# The CPQ Reconfigure API {#ariaid-title1}

Release version: Brazil  
Updated March 12, 2026  
![](https://www.servicenow.com/docs/portal-asset/ico-clock) 2 minutes to read
Summarize  
![AI sparkle icon](https://servicenow.com/docs/portal-asset/ai-sparkle-icon) Summarized using AI  
This content was generated using new OpenAI-powered functionality. Results are provided on an as is basis and are not guaranteed to be accurate or complete.  

## Summary of The CPQ Reconfigure API

The CPQ Reconfigure API is a custom Salesforce API designed to headlessly reconfigure existing quote bundles within CPQ services.
Unlike the RFQ API, this API specifically updates quote bundles by reconfiguring them based on provided configuration details.
Show full answer Show less  

## Prerequisites

* The Runtime Client Token must be configured in Salesforce's Admin Custom Settings, including an origin matching the ServiceNow CPQ URL (without a trailing slash).
* The Runtime Configuration URL should also be set, typically matching the administration URL in Admin Custom Settings.
* In Salesforce Setup, add your ServiceNow CPQ domain as a remote site URL under Security \> Remote Site Settings.
* Each product must have a unique **uniqueIdentifier** to ensure child lines are matched and updated correctly during reconfiguration.

## API Details and Usage

* **Endpoint:** `/services/apexrest/LGK/cpq-quote-lines/reconfigure`
* **Method:** PATCH, accepting and returning `application/json`
* **Supported Fields:** `configurationId` and `configurableQuoteLineId` only
* **Response:** Returns a complete quote record (`SBQQQuotec`) including all quote lines, both existing and newly added.

Requests can be made via REST or directly through Apex by passing a Map with the required fields. The Apex method returns a JSON string representing the updated quote object.

## Practical Considerations

* The API response includes all quote lines, which helps ServiceNow customers get a full view of the current quote configuration after reconfiguration.
* Custom field mapping is supported, allowing values from ServiceNow CPQ's extended or pricing information to populate matching fields on Salesforce Quote Line objects.

## Benefits for ServiceNow Customers

This API enables seamless, headless reconfiguration of quote bundles from ServiceNow to Salesforce CPQ, ensuring accurate and up-to-date quote lines without manual intervention. It supports integration workflows that require automated quote updates, helping maintain consistency and efficiency in quote management.  
The CPQ Reconfigure API headlessly invokes CPQ services to reconfigure a quote bundle.

The CPQ Reconfigure API is a custom Salesforce API that invokes CPQ services headlessly. Unlike RFQ, this API is used to reconfigure an existing quote bundle.

## Prerequisites {#cpq_reconfigure_api__section_dn4_53k_4hc}

The Runtime Client Token must be set in the Admin Custom Settings page in Salesforce. The token must include an origin that matches the ServiceNow CPQ URL, which cannot include a trailing slash (/) character.

The Runtime Configuration URL must also be set in the Admin Custom Settings page. In most cases, this should match the administration URL on the same page.

In Salesforce Setup, go to Security, and then to Remote Site Settings. Add a new remote site with your ServiceNow CPQ domain as the URL.

Important:  
This API relies on uniqueIdentifier to match child lines. If you don't have unique uniqueIdentifier values for products, child lines may update incorrectly.

## API details {#cpq_reconfigure_api__section_br2_pjk_4hc}

Endpoint: `/services/apexrest/LGK/cpq-quote-lines/reconfigure`  
Note:  
Request endpoints and parameters are case sensitive.

Methods: Receives and returns `application/json`.

PATCH: The method currently only supports two fields, `configurationId` and `configurableQuoteLineId`.

Response: A quote (`SBQQ__Q__c`) record.  
Note:  
The quote info returned will include info on all quote lines, not just the ones being added by the request. For example, if the configuration with three line items gets added to a quote that already had two lines on it, the quote info returned will included all five lines.

Request example:

    {
    	"configurationId":"86ec190e-cba8-4b1d-a2dc-ba47714a22b5",
    	"configurableQuoteLineId":"a137d00000977oWAAQ"
    }

Response example:

    {
    "attributes": {
    "type": "SBQQ__Quote__c",
    "url": "/services/data/v56.0/sobjects/SBQQ__Quote__c/a0zR0000003f3GLIAY"
    },
    "Name": "Q-00090",
    "Id": "a0zR0000003f3GLIAY",
    "SBQQ__LineItemCount__c": 4,
    "SBQQ__LineItems__r": {
    "totalSize": 4,
    "done": true,
    "records": [
    {
    "attributes": {
    "type": "SBQQ__QuoteLine__c",
    "url": "/services/data/v56.0/sobjects/SBQQ__QuoteLine__c/a0vR0000005LPRxIAO"
    },
    "SBQQ__Quote__c": "a0zR0000003f3GLIAY",
    "Id": "a0vR0000005LPRxIAO",
    "Name": "QL-0000122",
    "SBQQ__ProductName__c": "LGK Machine"
    },
    {
    "attributes": {
    "type": "SBQQ__QuoteLine__c",
    "url": "/services/data/v56.0/sobjects/SBQQ__QuoteLine__c/a0vR0000005LPRyIAO"
    },
    "SBQQ__Quote__c": "a0zR0000003f3GLIAY",
    "Id": "a0vR0000005LPRyIAO",
    "Name": "QL-0000123",
    "SBQQ__ProductName__c": "Analytics Software"
    },
    {
    "attributes": {
    "type": "SBQQ__QuoteLine__c",
    "url": "/services/data/v56.0/sobjects/SBQQ__QuoteLine__c/a0vR0000005LPS2IAO"
    },
    "SBQQ__Quote__c": "a0zR0000003f3GLIAY",
    "Id": "a0vR0000005LPS2IAO",
    "Name": "QL-0000124",
    "SBQQ__ProductName__c": "Extended Warranty"
    },
    {
    "attributes": {
    "type": "SBQQ__QuoteLine__c",
    "url": "/services/data/v56.0/sobjects/SBQQ__QuoteLine__c/a0vR0000005LPS3IAO"
    },
    "SBQQ__Quote__c": "a0zR0000003f3GLIAY",
    "Id": "a0vR0000005LPS3IAO",
    "Name": "QL-0000125",
    "SBQQ__ProductName__c": "Scanner"
    }
    ]
    },
    "SBQQ__Type__c": "Quote"
    }

Requests can be made directly through Apex. The argument is a `Map<String,Object>` with the same fields used in the REST API. For example:

    Map<String, Object> requestBody = new Map<String, Object>{
      'configurableQuoteLineId' => '01t8a000005hldvAAA',
      'configurationId' => '79a3ffdd-7dd0-41f6-8700-4bd7506407c7'    
    };
    String result = LGK.CpqReconfigureApiController.reconfigure(requestBody);

The response is a JSON formatted string representing the quote object, similar to the response in the REST APIs.

## Custom field mapping {#cpq_reconfigure_api__section_bsc_bkk_4hc}

If a field on the Quote Line object in Salesforce has a name that matches, custom values can be written from the `extended` or `pricing` information in a ServiceNow CPQ product.

