racket_quiz
Racket Finder quiz
Shows the Padel USA Racket Finder as a tappable quiz card (level, style, feel, arm comfort, budget...). The shopper answers with a few taps and the card shows the 3 best-fitting rackets with Shop now buttons. Use it only when the shopper asks to take the quiz or wants to answer the questions themselves; otherwise fill in the answers yourself and call find_racket.
Takes no parameters.
find_racket
Find my padel racket
Recommends the 3 best-fitting padel rackets for a player from the Padel USA store (in-stock rackets only; Padel USA ships within the United States). Uses the same matching engine as the Racket Finder on padelusa.com, ranked purely on fit to the player. Answer the Finder's questions yourself from what the shopper already said, instead of interviewing them: e.g. "I play 3 times a week and love to smash" = level intermediate, style aggressive; "my elbow hurts" = injury sometimes; "I'm new" = beginner; "under $200" = max_price_usd 200. Call it as soon as you can infer the level; ask at most one short question only if you cannot guess it. Leave out what you cannot infer (never make up arm pain, age or budget). The result includes accessories the player needs with the racket (an overgrip always, an arm sleeve if they have arm pain); offer them in one sentence. Show each pick with its name, price, the reasons, and its product link. To buy, call add_to_cart with the pick's variant_id, then build_kit to complete the kit.
Parametersagefeellevelrequiredstylegenderinjurydislikeprior_sportcurrent_shapemax_price_usdcurrent_racketwomen_suitable_first
racket_details
Padel USA racket details
Looks up up to 3 rackets by name in the Padel USA store and returns their specs (shape, balance, weight, core feel, handling, level, play style, surface), price, and product and add-to-cart links. Use it to answer questions about a specific racket or to compare 2 or 3 rackets side by side. A racket that is not returned is not currently sold in stock by Padel USA.
Parametersnamesrequired
search_products
Search Padel USA gear
Finds in-stock padel gear at Padel USA other than a racket fit: shoes, balls, bags, overgrips, accessories, bundles (and rackets by name or brand). Returns up to 6 items with price, available sizes/options with their variant_id, and links. For racket recommendations use find_racket instead.
Parameterssizequerygendercategoryrequiredmax_price_usd
build_kit
Build my padel kit
Completes a racket with what the player needs: balls, an overgrip, a bag, and shoes when a US shoe size is given. One in-stock pick per slot with a short reason and its variant_id, ready for add_to_cart.
Parameterslevelgendershoe_sizebudget_usdracket_brand
add_to_cart
Add to Padel USA cart
Adds items to the shopper's Padel USA cart (creates the cart on first use). Pass the cart_id from the previous cart result to keep adding to the same cart. Give the shopper's 5-digit US ZIP to show shipping options. If the result has "essentials", mention them once in one sentence with their reason (things the player genuinely needs with this cart, never an upsell push) and add them only if the shopper says yes; never repeat the suggestion. Show the cart, then offer checkout_url: the shopper pays on Padel USA's secure Shopify checkout (Shop Pay, cards, PayPal) and enters the delivery address there. Never ask for payment details in chat.
Parameterszipitemsrequiredneedscart_id
update_cart
Change Padel USA cart
Changes quantities in the cart (0 removes the line) and/or the delivery ZIP. If the result has "essentials", mention them once in one sentence with their reason (things the player genuinely needs with this cart, never an upsell push) and add them only if the shopper says yes; never repeat the suggestion. Show the cart, then offer checkout_url: the shopper pays on Padel USA's secure Shopify checkout (Shop Pay, cards, PayPal) and enters the delivery address there. Never ask for payment details in chat.
Parameterszipneedscart_idrequiredchanges
view_cart
View Padel USA cart
Shows the cart: items, subtotal, shipping options for the ZIP, and the checkout link. If the result has "essentials", mention them once in one sentence with their reason (things the player genuinely needs with this cart, never an upsell push) and add them only if the shopper says yes; never repeat the suggestion. Show the cart, then offer checkout_url: the shopper pays on Padel USA's secure Shopify checkout (Shop Pay, cards, PayPal) and enters the delivery address there. Never ask for payment details in chat.
Parametersneedscart_idrequired
padel_guide
Padel USA guides
Finds Padel USA's own guides for a padel question (rules, technique, choosing gear, care, sizing). Returns up to 3 articles with a summary and link. Use it to answer as a padel expert and cite the guide.
Parametersquestionrequired
order_help
Padel USA order help
After a purchase: where to track an order, start a return or exchange, file a warranty claim, report a lost or damaged parcel, or contact the team. Returns the right Padel USA page. Never ask for order numbers or email addresses in chat; the page verifies the shopper.
Parameterstopicrequired