For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
Dev Portal
DocsAPI ReferenceLearnCommunityChangelog
DocsAPI ReferenceLearnCommunityChangelog
    • About Our APIs
  • REST
    • Overview
      • Overview
      • Storefront
          • Authentication
          • Catalog
          • Company
          • Orders
          • Request for Quote
          • Sales Rep
          • Shopping List
            • GETList Shopping Lists
            • POSTCreate Shopping List
            • PUTUpdate Shopping List
            • GETGet Shopping List ID and Name
            • POSTAdd Shopping List Items
            • PUTUpdate Shopping List Items
            • GETList Shopping List Items Extension
            • DELDelete Shopping List Item
            • DELDelete Shopping List
            • POSTDuplicate Shopping List
          • Store Settings
      • Management
  • GraphQL
    • Overview
  • MCP
    • Overview
Dev Portal
LogoLogo
RESTB2BStorefrontShopping List

Add Shopping List Items

POST
https://api-b2b.bigcommerce.com/api/v2/shoppinglists/items
POST
/api/v2/shoppinglists/items
$curl -X POST https://api-b2b.bigcommerce.com/api/v2/shoppinglists/items \
>     -H "Authorization: Bearer <token>" \
>     -H "Content-Type: application/json" \
>     -d '{
>  "id": "string",
>  "items": [
>    {
>      "productId": "string",
>      "variantId": "string",
>      "qty": "string",
>      "optionList": [
>        {
>          "option_id": "string",
>          "option_value": "string"
>        }
>      ]
>    }
>  ],
>  "checkAddStatus": true
>}'
200example-1
1{
2  "code": 200,
3  "message": "SUCCESS",
4  "data": {}
5}
Add items to an existed shopping list. Equivalent Storefront GraphQL API Mutation: `shoppingListsItemsCreate`. For more information, see the [GraphQL Playground](https://api-b2b.bigcommerce.com/graphql/playground).
Was this page helpful?
Previous

Get Shopping List ID and Name

Next

Update Shopping List Items

Built with

Add items to an existed shopping list. Equivalent Storefront GraphQL API Mutation: shoppingListsItemsCreate. For more information, see the GraphQL Playground.

Authentication

AuthorizationBearer

Authentication header

HeaderArgumentDescription
AuthorizationBearer {{B2B_JWT_TOKEN}}You can obtain this token using the steps described in the REST Storefront API section[…]

Request

idstringRequired>=1 character
Shopping list ID
itemslist of objectsRequired

Response

OK
codedouble
messagestring>=1 character
dataobject