BMWUSA

Remove an inventory vehicle from your inventory favorites

remove-inventory-favorite

Remove an option from an existing BMW configuration. ONLY USE THIS TOOL WHEN A USER REQUESTS TO REMOVE AN OPTION. Requires configId (session identifier from configuration or favorites) and optionCode. Do NOT use this to “fix” missing options that the user stated before configuration start—those should have been included initially via 'start-configuration' after checking with 'get-available-options'. Returns updated configuration with the option removed, updated price, and available options. You MUST review the response before informing the customer the configuration has been updated. The widget already shows the vehicle images. Do not add images or image links to your reply. NEVER share codes with the user. COMBINATION PRICING: When removing an option, prices may change due to combination pricing rules: - Other options that had combination pricing with the removed option may revert to their base prices. - The total configuration price is ALWAYS correct and reflects all active combination pricing. Check the response carefully to explain accurate pricing changes to the user.

remove-configuration-option

Save a BMW Build Your Own (BYO) configuration to your favorites for later reference. You can only save a max of 5 configurations. If you save more, the oldest one will be removed. You may not be able to retrieve a saved configuration later if the build is no longer available. Reasons for this include: - New Model Year Available (we will try to update on retrieval) - Model Discontinued

save-configuration-favorite

Save a BMW inventory vehicle to your favorites for later reference. You can save a max of 5 vehicles. Saving additional vehicles will remove the oldest favorite.

save-inventory-favorite

Search for BMW models using fuzzy text matching or structured filters. Text search matches model names, series (e.g. 'x5', 'm3'), and body styles (e.g. 'sedan'). Use filters for precise searches: series (enum), bodyStyle (enum), price range, year, driveTrain, horsepower. Returns modelCode needed for payment estimation. MAKE SURE TO USE THE MODEL NAMES RETURNED and correct the customer's request.

search-models

Search new BMW vehicle inventory at dealers near a US zipcode. Put only vehicle criteria in the search query, such as model, trim, color, options, or price range. Adjust limit to find more or fewer vehicles.

search_bmw_inventory

Find a specific BMW special offer details by ID. The id is available from the special-offers tool

special-offer-details

Find BMW special offers with optional filters. Make sure to get the available filters first

special-offers

Find filters available for special offers

special-offers-filters

Start a new Build Your Own (BYO) BMW configuration build/session. Use this if a customer wants to configure/build/design a vehicle. Requires a modelCode (get from search-models tool, e.g., "26XD" for X3 30 xDrive). Use this tool ONLY AFTER you have identified which options the user wants to include at the start. ❗ MANDATORY RULE: If the user expresses preferences BEFORE starting a configuration (e.g., a specific paint, wheels, interior, packages, etc.), you MUST call 'get-available-options' FIRST and then pass the appropriate option codes into the 'options' array here. Optionally include an array of option codes to pre-configure the vehicle. This is REQUIRED when the user has already stated preferences — you MUST NOT start the configuration without including them. This tool returns: - model details, - currently selected options, - ALL available options organized by category, - active combination pricing, - current price and priceWithDestAndHandling, - configurationId (required for add/remove calls). Configuration session is maintained via cookies. If the tool returns an error that the model cannot be loaded or is not found, you need to find the latest modelCode for the model and try again. MODEL CODES: - If the user requests a model that is not found or no longer available, use the search-models tool to get the latest code. - NEVER expose model codes to the user. ADDITIONAL USE CASES: - Use this tool to start configurations when users want to answer complex questions about pricing & configurability with specific options. STARTING OPTIONS: - Use the get-available-options tool to find options before starting a configuration. - If the user requests specific options at start, you MUST include them in the options array, do not call start then add. - After starting, verify if requested options were added successfully and inform the user, including any additional options that were added. INVENTORY-INITIATED CONFIGURATIONS: - When starting a configuration from an inventory vehicle, you can use the complete list of option codes provided from the inventory data. - These codes may include options that don't appear in the get-available-options response (e.g., dealer-installed accessories, special packages, or region-specific options). - It is acceptable to pass these codes to the options array even if they weren't validated with get-available-options first. - The configuration API will handle any incompatible codes gracefully, and you should inform the user which options were successfully applied. COMBINATION PRICING: Options may have combinationPrices and reverseCombinationPrices fields that show how prices change when options are combined: - combinationPrices: Shows how THIS option's price changes when combined with other features. The combPrice is the absolute replacement price (not a discount). - reverseCombinationPrices: Shows how THIS option affects OTHER features' prices when combined. - For selected options: the price field already reflects any active combination pricing. - For available options: the price field shows the base price; use combinationPrices to see pricing impacts. IMPORTANT: - The total configuration price (current.price, current.priceWithDestAndHandling) is ALWAYS correct and reflects all active combination pricing. - You MUST check the response carefully to determine if the features were added as not every option may work together. - Make it clear to the user which options were unable to be added and offer to add them separately. The widget already shows the vehicle images. Do not add images or image links to your reply.

start-configuration

Submit a test drive request to BMW for a specific dealer, date, and time slot. This will send the lead to BMW and the dealer will reach out to confirm the appointment. Use the dealer name in any UI or conversation. NEVER mention the dealerId directly. Always ask a user to pick a time slot via the test-drive-availability tool before calling this tool. IMPORTANT: Always call this tool with the user's requested date. Do NOT validate or reject dates yourself — the server will handle date validation and return a helpful error if needed. You MUST inform the user that by submitting they agree to the following consent. you MUST show the exact text to the user either in the UI or conversation. " Before proceeding I need to collect your consent: I instruct BMW of North America, LLC to provide my information to an authorized BMW dealership. I understand that an authorized BMW Dealership may contact me with offers or information about their products and services. I direct BMW of North America, LLC to disclose my contact information to an authorized BMW dealer who may send me text messages to market or advertise products, goods or services. These text messages may be transmitted through autodialed calls or robotexts. By submitting my contact information, I confirm that I am the current owner/subscriber of the mobile phone number provided or that the current owner/subscriber of this mobile phone number authorized me to provide this number to BMW of North America, LLC and BMW dealers. I understand that my consent is not required as a condition of purchase and that I can revoke my consent at any time. Wireless and text message fees may apply from your carrier. I will contact the dealer directly to provide it reasonable notice if I no longer wish to receive automated calls or text messages.We respect your privacy. When you submit your contact information, we agree to only contact you in accordance with BMW of North America, LLC Privacy Policy. "

submit-test-drive-request