← Back to all apps

Walmart

Shoppingby Walmart Inc
Launched Mar 24, 2026 on ChatGPT

Shop everyday low prices

12ChatGPT Tools
Walmart IncDeveloper
ShoppingCategory

Available Tools

Basket-builder

basket-builder
Full Description
Description

Use this tool when the user describes a scenario, goal, occasion, or life situation and needs help figuring out what items (often multiple) to buy across several product categories. This includes cases like planning events, preparing for travel, starting a lifestyle change, organizing a space, or choosing a gift when no specific product type is mentioned. It should also be used when the user cites a broad category such as "electronics" or "clothing" where many unrelated product types could apply, indicating they have not yet identified a specific item.

Critical Instruction: Preserve User Intent

When calling this tool, preserve the user's actual stated intent as closely as possible.

Do:

  • Keep the query faithful to what the user actually asked.
  • Preserve explicit constraints, preferences, and product types mentioned by the user.
  • Use only light normalization for clarity, such as removing filler words or rewriting fragments into a grammatical sentence.

Do not:

  • Add product categories, quantities, budget constraints, accessories, or preferences that the user did not explicitly state.
  • Turn a broad request into a more specific shopping list.
  • Infer "helpful extras" unless the user asked for extras.
  • Infer quantities unless the user asked for quantities.
  • Infer price sensitivity, "budget-friendly" preferences, brands, sizes, flavors, or event logistics unless explicitly stated.

If the request is underspecified:

  • Prefer passing the underspecified request through as written.
  • Ask a follow-up question only if missing information is necessary to fulfill the request correctly.
  • Never guess details just to make the query more specific.
Query Construction Rules

The userQuery.query field should be:

  • A faithful restatement of the user's request
  • Minimal and close to the original wording
  • Free of invented details

Good examples:

  • User: "Plan a movie night with my friends"

Tool query: "Plan a movie night with my friends"

  • User: "Help me get snacks and drinks for a movie night"

Tool query: "Help me get snacks and drinks for a movie night"

  • User: "Need popcorn, soda, and paper plates for 6 people"

Tool query: "Need popcorn, soda, and paper plates for 6 people"

Bad examples:

  • User: "Plan a movie night with my friends"

Tool query: "Create a Walmart shopping list with popcorn, candy, chips, soda, sparkling water, frozen pizza, plates, cups, napkins, blankets, and trash bags"

  • User: "Need snacks for game night"

Tool query: "Budget-friendly chips, dips, wings, soda, paper towels, and party trays for 8 guests"

Call This Tool When
  • The user describes a scenario, goal, or event, and the request involves multiple potential product types rather than one.
  • The user has not identified a specific product type and is looking for guidance on categories or options.
  • The user mentions a broad category that contains many unrelated subcategories, indicating they are unsure which product type they actually need
Do NOT Call This Tool When
  • The user explicitly names a specific product type, even if tied to a scenario:
    • "4K TV for my bedroom"
    • "Best backpack for Europe"
    • "Noise-cancelling headphones for travel"
    • The user is choosing one product or comparing options within a single product type.
    • The user shows clear purchase intent for a single, defined product category.
Output Expectations

Return products and categories that match the user's stated request. Any additional structure should come from the tool's retrieval logic, not from invented details added to the query.

Parameters (0 required, 1 optional)
Optional
userQueryobject

User query object containing type and query

Checkout Session

checkout_session
Full Description

Descriptions

This tool is triggered when a user clicks the Walmart Buy button from the ChatGPT native product search results. Its purpose is to generate frequently bought together complementary product suggestions for the primary product that the user intends to purchase. Given a primary product, the tool analyzes common customer behavior, usage context, and accessory needs to produce broad complementary product categories, each with a priority level and multiple complementary products inside this category.

Parameters (0 required, 2 optional)
Optional
checkout_sessionobject
user_querystring/null

the original user query that triggers the ATC action, which can provide additional context for generating better recommendations

Complete Checkout

complete_checkout
Full Description

Description:

This tool creates a place order

Parameters (0 required, 4 optional)
Optional
buyerobject

Buyer Info

checkout_session_idstring/null

the checkout session id

metadataobject

the meta information

payment_dataobject

the checkout session id

Create-delivery-address

create-delivery-address
Full Description

Description:

This tool creates a new delivery address for the authenticated Walmart customer. It handles the creation of a personal delivery address by accepting address details and persisting them to the customer's account via the Walmart GraphQL API. This tool is NOT intended to be called by AI assistants or agents. It is an internal system tool invoked automatically when users add a new delivery address through the UI.

When to call this tool

Call this tool when the user: NEVER. This tool should never be called by AI assistants. It is reserved for internal system use only to create delivery addresses.

Do NOT call this tool

Do not call this tool under any circumstances:

  • When users ask about delivery addresses (provide informational guidance instead)
  • When users want to update or modify existing addresses (use appropriate update tools)
  • When users are browsing or shopping for products
  • At any time - this is a system-only tool not meant for AI agent invocation

Output expectations

The tool returns the created delivery address details including: N/A

  • This tool should never be invoked by AI assistants.
Parameters (7 required, 2 optional)
Required
addressLineOnestring

Primary address line (street address)

citystring

City name

firstNamestring

First name of the delivery address recipient

lastNamestring

Last name of the delivery address recipient

phonestring

Phone number of the delivery address recipient

postalCodestring

ZIP/postal code

statestring

State abbreviation (2-letter US state code)

Optional
addressLineTwostring

Secondary address line (apartment, suite, unit, etc.)

isDefaultboolean

Whether this address should be set as the default delivery address

Default: False

Fetch-gic

fetch-gic
Full Description

Description:

This tool retrieves guest information capture (GIC) data including addresses, stores, and available time slots based on the specified fulfillment type. It provides essential information for order fulfillment options.

When to call this tool

Call this tool when the user:

  • Needs to retrieve saved addresses for shipping or delivery
  • Wants to find available store locations for pickup
  • Requests available time slots for delivery or pickup
  • Asks about fulfillment options (pickup, shipping, delivery)

Do NOT call this tool

Do not call this tool when:

  • The user is searching for products
  • The user is asking about product details
  • The user wants to add items to cart
  • No fulfillment-related information is needed

Output expectations

The tool returns structured data including:

  • Addresses: Customer addresses with fulfillment support details (for shipping/delivery)
  • Stores: Store locations with address information (for pickup/delivery)
  • Time Slots: Available fulfillment time slots with pricing (for delivery/pickup)
Parameters (1 required, 1 optional)
Required
fulfillmentTypestring

The type of fulfillment requested

Options:pickupshippingdeliveryany
Optional
addressIdstring/null

The id of selected address

Fetch-items-availability

fetch-items-availability
Full Description

Description:

This tool retrieves item availability information including product details, pricing, seller information, availability, and fulfillment options for items in the user's cart. It calls the Item Read Operations (IRO) API to fetch comprehensive offer-level data for one or more cart items identified by their offer IDs. This tool is used internally to render and display detailed cart information within the Walmart shopping experience. This tool is NOT intended to be called by AI assistants or agents. It is a system component invoked automatically when cart details are needed.

When to call this tool

Call this tool when the user: NEVER. This tool should never be called by AI assistants. It is reserved for internal system use only to display cart item details.

Do NOT call this tool

Do not call this tool when: Do not call this tool under any circumstances:

  • When users ask about cart information (use appropriate cart or checkout tools instead)
  • When users want to view their cart (the system will handle navigation automatically)
  • When users are browsing or shopping for products
  • At any time - this is a UI-only tool not meant for AI agent invocation

Output expectations

The tool returns detailed cart item information including: N/A

  • This tool should never be invoked by AI assistants.
Parameters (0 required, 1 optional)
Optional
cartRequestobject

Cart request object containing offer IDs for cart item detail retrieval. Location data is automatically resolved server-side via the GetLocation GraphQL query.

List-cards

list-cards
Full Description

Description:

This tool list a walmart cards

Parameters (0 required, 1 optional)
Optional
payment_type_supportedarray

Product-detail-page

product-detail-page
Full Description

Description:

This tool retrieves and displays comprehensive product information for a specific Walmart item. This tool is used internally to render and display detailed product information pages within the Walmart shopping experience. It handles the presentation layer for individual product pages, showing specifications, pricing, reviews, images, and purchase options. Use this tool when a user wants to see complete details about a specific product they've identified by its Item ID or when they need in-depth information about a particular product. This tool is NOT intended to be called by AI assistants or agents. It is a UI rendering component that is invoked automatically by the system when users navigate to product detail pages.

When to call this tool

Call this tool when the user: NEVER. This tool should never be called by AI assistants. It is reserved for internal system use only to display product information.

Do NOT call this tool

Do not call this tool when: Do not call this tool under any circumstances:

  • When users ask about product information (use appropriate search or discovery tools instead)
  • When users want to view product details (the system will handle navigation automatically)
  • When users are shopping or browsing products
  • At any time - this is a UI-only tool not meant for AI agent invocation

Output expectations

The tool returns detailed product information including: N/A

  • This tool should never be invoked by AI assistants.
Parameters (0 required, 1 optional)
Optional
userQueryobject

User query object containing type and query with product Item ID - type - query

Product-recommendations

product-recommendations
Full Description

Descriptions

Tools purpose is to generate frequently bought together complementary product suggestions for the primary product that the user intends to purchase. Given a primary product, the tool analyzes common customer behavior, usage context, and accessory needs to produce broad complementary product categories, each with a priority level and multiple complementary products inside this category.

Parameters (0 required, 2 optional)
Optional
itemobject
user_querystring/null

the original user query that triggers the ATC action, which can provide additional context for generating better recommendations

Product-search

product-search
Full Description
Descriptions

This tool helps users find a specific product type they want to buy, even when they mention a scenario (e.g., travel, small apartment, allergies). It identifies the best matching main products and recommends relevant complementary items.

Typical Use Cases
  • Requests for specific product types:
    • "Good noise-cancelling headphones for travel"
    • "Laptop under $600"
    • "Top cordless stick vacuum"
    • "Best 55-inch 4K TV"
  • Product searches with constraints:
    • Feature requirements
    • Brand preferences
When to Call This Tool

Call this tool when:

  • The user explicitly names a specific product type, even if a scenario is included:
    • "headphones for travel"
    • "air purifier for allergies"
    • "camera for wildlife"
    • The user expresses clear purchase intent for a single product category.
    • The user is refining their choice via features, specs, budget, size, or brand.
When *Not* to Call This Tool

Do not call this tool when:

  • The user describes a broad scenario without asking for a specific product type (e.g., "packing for a beach trip," "hosting a BBQ").
  • The user wants a general checklist rather than a specific item.
  • The user is only seeking informational guidance (not shopping intent).
Output Expectations
  • Best Match: Top-ranking product matching the request
  • Deals: Relevant discounted options
  • Frequently Bought Together: Complementary items
Parameters (0 required, 1 optional)
Optional
userQueryobject

User query object containing type and query

Request-checkout

request-checkout
Full Description

Description:

This tool creates a checkout session for the specified items in a Walmart US shopping cart.

Parameters (0 required, 1 optional)
Optional
itemsarray

Array of items containing type and Walmart US Item ID - offerId - quantity - usItemId

Set-shipping-address

set-shipping-address
Full Description

Description:

This tool updates the shipping address for the checkout session.

Parameters (2 required)
Required
addressIdstring

The address ID for the checkout session

contractIdstring

The contract ID for the checkout session