BigCommerce Docs

Creates a sales quote from the storefront and submits it to the B2B Edition control panel.

Depending on your store’s Quote settings configuration, this can be used anonymously to create a quote as a guest shopper, or authenticated with a B2C storefront customer or B2B Company user account. Quotes created with this endpoint share the same minimum required fields as the Create a Quote endpoint in the Server to Server API.

Draft Quotes

The Buyer Portal allows buyers to save “draft” quotes” that they can edit further until they are ready to submit the quote to their sales representative. The built-Buyer Portal uses local storage, via the Redux library, to store a draft quote’s details. This is different from quotes created within the B2B Edition control panel in Draft status, which is saved to the account itself and is visible to all backend users.

The Create a Quote endpoint should only be used once a quote is ready to submit to a sales representative. Your application must save quote details in its own storage in order to support draft quotes.

Equivalent Storefront GraphQL Mutation: quoteCreate.

Pricing Field Considerations

Note the following considerations related to pricing fields in the request:

Quotes created with this endpoint undergo a price validation check to prevent invalid prices. If the check fails, a BigCommerce API Error will be raised and logged, preventing quote creation.
- To create quotes with custom pricing, use Create a Quote Form (Server-to-Server).
The discount field is present in the request body and the productList array; however, the value must be 0, since quote discounts are supplied by the sales rep.
The offeredPrice field on each item in the productList array must be provided, but it must equal the basePrice value for that product, since it is meant to reflect the quoted price which should not be different at this stage.
The subtotal and grandTotal fields must be equal to the sum of each product’s offeredPrice multiplied by the quantity.

Creates a sales quote from the storefront and submits it to the B2B Edition control panel. Depending on your store's Quote settings configuration, this can be used anonymously to create a quote as a guest shopper, or authenticated with a B2C storefront customer or B2B Company user account. Quotes created with this endpoint share the same [minimum required fields](/developer/api-reference/rest/b2b/management/quotes#minimum-required-fields) as the Create a Quote endpoint in the Server to Server API. ### Draft Quotes The Buyer Portal allows buyers to save "draft" quotes" that they can edit further until they are ready to submit the quote to their sales representative. The built-Buyer Portal uses local storage, via the [Redux](https://redux.js.org/) library, to store a draft quote's details. This is different from quotes created within the B2B Edition control panel in Draft status, which is saved to the account itself and is visible to all backend users. The Create a Quote endpoint should only be used once a quote is ready to submit to a sales representative. Your application must save quote details in its own storage in order to support draft quotes. Equivalent Storefront GraphQL Mutation: `quoteCreate`. ### Pricing Field Considerations Note the following considerations related to pricing fields in the request: * Quotes created with this endpoint undergo a price validation check to prevent invalid prices. If the check fails, a `BigCommerce API Error` will be raised and logged, preventing quote creation. * To create quotes with custom pricing, use [Create a Quote Form (Server-to-Server)](/developer/api-reference/rest/b2b/management/quotes#create-a-quote-form). * The `discount` field is present in the request body and the `productList` array; however, the value must be 0, since quote discounts are supplied by the sales rep. * The `offeredPrice` field on each item in the `productList` array must be provided, but it must equal the `basePrice` value for that product, since it is meant to reflect the quoted price which should not be different at this stage. * The `subtotal` and `grandTotal` fields must be equal to the sum of each product's `offeredPrice` multiplied by the `quantity`.

Authentication

AuthorizationBearer

Authentication header

Header	Argument	Description
`Authorization`	`Bearer {{B2B_JWT_TOKEN}}`	You can obtain this token using the steps described in the REST Storefront API section[…]

### Authentication header | Header | Argument | Description | |:-------|:---------|:------------| |`Authorization`|`Bearer {{B2B_JWT_TOKEN}}`| You can obtain this token using the steps described in the [REST Storefront API](/developer/docs/b2b-edition/getting-started/authentication#rest-storefront-api) section[...]

Request

This endpoint expects an object.

companyIddoubleRequired

The unique identifier for the Company account associated with the quote. This field is required when creating a quote for a Company account.

storeHashstringRequired

The unique store hash for the BigCommerce store.

grandTotaldoubleRequired

The quoted total after discounts, shipping, and tax are applied.

discountdoubleRequired

The total value of discounts applied to the quote. This is presented as a fixed value instead of a percentage.

userEmailstringRequiredformat: "email"

The email address of the buyer associated with the quote.

productListlist of objectsRequired

Line item information for the quote.

contactInfoobjectRequired

This object contains the contact information for the buyer in the quote.

expiredAtstringOptional

Use ‘%m/%d/%Y’ format when entering the expiration date.

quoteTitlestringOptional

The external title given to the quote.

referenceNumberstringOptional

An identifier for the quote that can be supplied by the sales rep or the buyer, such as a Purchase Order number.

notesstringOptional

The quote’s buyer-facing notes. Use the newline character to separate each line of text.

legalTermsstringOptional

The quote's terms and conditions. Use the newline character to separate each line of text. Omitting this field or leaving it blank does not add your store's default terms and conditions to the quote. Instead, the quote will not display any terms.

subtotaldoubleOptional

The quoted total after discounts and before shipping and tax.

isBackendUserenumOptional

Indicates whether the quote was created by a frontend user like a buyer or Super Admin, or it was created by a backend user like Sales Staff.

Allowed values:

currencyobjectOptional

Contains detailed information regarding the quote's currency.

shippingAddressobjectOptional

Contains information for the shipping address on the quote.

bcCustomerIdintegerOptional

The unique ID for the customer account.

channelIdintegerOptional

The storefront channel ID associated with the quote. This is required if your store has multiple storefront channels. Use '1' for your store's default storefront channel.

Response

codeintegerDefaults to 200

messagestringDefaults to SUCCESS

dataobject

Errors

400

Bad Request Error

Creates a sales quote from the storefront and submits it to the B2B Edition control panel.

Draft Quotes

Equivalent Storefront GraphQL Mutation: quoteCreate.

Pricing Field Considerations

Note the following considerations related to pricing fields in the request:

Quotes created with this endpoint undergo a price validation check to prevent invalid prices. If the check fails, a BigCommerce API Error will be raised and logged, preventing quote creation.
- To create quotes with custom pricing, use Create a Quote Form (Server-to-Server).
The discount field is present in the request body and the productList array; however, the value must be 0, since quote discounts are supplied by the sales rep.
The offeredPrice field on each item in the productList array must be provided, but it must equal the basePrice value for that product, since it is meant to reflect the quoted price which should not be different at this stage.
The subtotal and grandTotal fields must be equal to the sum of each product’s offeredPrice multiplied by the quantity.

1	curl -X POST https://api-b2b.bigcommerce.com/api/v2/rfq \
2	-H "Authorization: Bearer <token>" \
3	-H "Content-Type: application/json" \
4	-d '{
5	"companyId": 123456,
6	"storeHash": "1234abcd",
7	"grandTotal": 1250,
8	"discount": 0,
9	"userEmail": "mcurie@greatbuysinc.com",
10	"productList": [
11	{
12	"sku": "SAN-PL",
13	"basePrice": 25,
14	"discount": 0,
15	"offeredPrice": 25,
16	"quantity": 50,
17	"productId": 12345,
18	"variantId": 74768,
19	"imageUrl": "https://cdn11.bigcommerce.com/s-1234abcd/products/12345/images/3080/sansevieria-1__58536__96021.1736973469.500.659.jpg?c=1",
20	"orderQuantityMaximum": 0,
21	"orderQuantityMinimum": 0,
22	"productName": "Sansevieria",
23	"options": [
24	{
25	"optionId": 3780,
26	"optionName": 3780,
27	"optionLabel": "12",
28	"optionValue": 18863
29	}
30	]
31	}
32	],
33	"contactInfo": {
34	"name": "Marie Curie",
35	"email": "mcurie@greatbuysinc.com",
36	"companyName": "Great Buys Incorporated",
37	"phoneNumber": "(512) 333-3333"
38	},
39	"quoteTitle": "Plants Bulk Request",
40	"referenceNumber": "04292025-0001",
41	"subtotal": 1250,
42	"isBackendUser": true,
43	"currency": {
44	"location": "left",
45	"token": "$",
46	"decimalToken": ".",
47	"decimalPlaces": 2,
48	"thousandsToken": ",",
49	"currencyCode": "USD"
50	},
51	"shippingAddress": {
52	"address": "512 Bluebonnet Lane",
53	"apartment": "Suite 100",
54	"city": "Austin",
55	"state": "Texas",
56	"zipCode": "78750",
57	"country": "United States"
58	},
59	"bcCustomerId": 123,
60	"channelId": 1
61	}'

1	{
2	"code": 200,
3	"message": "SUCCESS",
4	"data": {
5	"quoteId": 123456,
6	"quoteUrl": "https://mybcstore.com/#/quoteDetail/123456?date=1745942332"
7	}
8	}