1800Flowers

Open in ChatGPT →

Overview

Tools Available6

Developer1-800-FLOWERS.COM, Inc.

CategoryShopping

Shop flowers and gifts

Available Tools

1800Flowers provides 6 tools that can be used to interact with its services.

Add to Cart

add_to_cart

Full Description

Use this to call internal cart services to create a cart for the customer. It will return a link to the cart that they can use to checkout with on the brand website. Just note that these links each will have a different reference id and, therefore, the customer will need to click on each one if this tool is used more than one time!

Parameters

Required

customerEmailstring

The email of the customer

parentProductCodestring

The parent product code/part number of the product to create a new cart with.

variantProductCodestring

The variant product code/part number of the product to create a new cart with.

Optional

deliveryDatestring

The delivery date for the cart in format MM/DD/YYYY HH:MM:SS

greetingstring

The greeting to be used for the cart. Max 175 characters.

primaryBrandstring

The brand of the product to create a new cart with. Strict values include: 1800flowers, harryanddavid

Default: 1800flowers

quantitystring

The quantity of the product to create a new cart with.

Default: 1

recipientAddress1string

The address line 1 of the recipient

recipientAddress2string

The address line 2 of the recipient

recipientAddress3string

The address line 3 of the recipient

recipientCitystring

The city of the recipient

recipientFirstNamestring

The first name of the recipient

recipientLastNamestring

The last name of the recipient

recipientLocationTypestring

The location type for the cart. Valid values are RESIDENCE or BUSINESS

recipientOrganizationNamestring

The organization name if it is a business location

recipientPhoneNumberstring

The phone number of the recipient

recipientRelationshipstring

The relationship of the recipient to the customer one of: client, colleague, family, other, friend, wife, husband, self, girlfriend, boyfriend, aunt, uncle, grandma, grandpa, sister, brother, daughter, son, dad, mom

recipientStatestring

The state of the recipient

recipientZipCodestring

The zip code of the recipient

session_idstring

Frontend session ID for tracking user journey across frontend and backend

Company Help & FAQs

company_faqs

Full Description

Use this to search the company FAQs to find clear answers to common questions.

Parameters

Required

querystring

The query to search the company FAQs for.

Optional

brandstring

The brand of the product to search the company FAQs for. Strict values include: 1800flowers, harryanddavid

Default: 1800flowers

session_idstring

Frontend session ID for tracking user journey across frontend and backend

Get Delivery Dates and Shipping Costs

get_delivery_dates_and_shipping_costs

Full Description

This tool gets delivery dates and shipping costs for each delivery date! Use this to get the delivery dates for a product or gift by its child product code and zip code. The child product code is the sku of the variant. You may need to use the get_product_details tool to get the child product code.

Parameters

Required

childProductCodestring

The child product code of the product to look up the delivery dates for. The child product code is the sku of the variant. You may need to use the get_product_details tool to get the child product code.

zipCodestring

The zip code of the location to look up the delivery dates for.

Optional

brandstring

The brand of the product to look up the delivery dates for. Strict values include: 1800flowers, harryanddavid

Default: 1800flowers

brandCodestring

The brand code for the product to look up the delivery dates for. Strict value is 1001

Default: 1001

customerTypestring

The customer type for the delivery dates. Valid values are G, R, or P

Default: G

locationTypestring

The location type for the delivery dates. Valid values are RESIDENCE or BUSINESS

Default: Residence

session_idstring

Frontend session ID for tracking user journey across frontend and backend

Order Status and Tracker

get_order_status

Full Description

Use this to get the status of a customer's order using their order number, email, or billing phone number. To protect privacy, verification requires three pieces of identifying information (e.g., order number + email + phone) to use this tool. An error will be thrown if less than 3 pieces of identifying information are provided. Please provide at least 3 pieces of information (1 being either the orderNumber, email, or billingPhoneNumber) among the following: orderNumber, recipientName, customerName, email, billingZipCode, recipientZipCode, billingPhoneNumber, deliveryDate. Never assume a name is for a customer or a recipient or that a zip code is for a customer or a recipient. Always ask for clarification if needed.

Parameters

Optional

billingPhoneNumberstring

The phone number of the billing address.

billingZipCodestring

The zip code of the billing address. Can only be used for validation if the order number is also provided

customerNamestring

The first and last name of the customer.

deliveryDatestring

The delivery date for the order in format in YYYY-MM-DD format

emailstring

The email of the customer (that the order was placed with).

orderNumberstring

The order number to get the status of.

recipientNamestring

The first and last name of the recipient.

recipientZipCodestring

The zip code of the recipient/delivery address.

session_idstring

Frontend session ID for tracking user journey across frontend and backend

Product & Gift Details

get_product_details

Full Description

Use this to get the details of a specific product or gift if the customer asks for a specific product

Parameters

Required

partNumberstring

The part number of the product to look up.

Optional

brandstring

The brand of the product to look up. Strict values include: 1800flowers, harryanddavid

Default: 1800flowers

session_idstring

Frontend session ID for tracking user journey across frontend and backend

Product & Gift Finder Search

search_products

Full Description

Use this to Search for products or gifts by search terms and get the top product picks. If the customer provides a zip code and delivery date, the products will be filtered to only include products that are available for that zip code and delivery date!

Parameters

Required

search_termsstring

Keywords to search for gifts or products.

Optional

brandstring

The brand of the products to search for. Strict values include: 1800flowers, harryanddavid

Default: 1800flowers

delivery_datestring

The optional delivery date for the products in format in DD-MMM-YY format. This will only work if the zip code is also provided.

max_pricenumber

The optional maximum price of the products to search for.

Default: null

min_pricenumber

The optional minimum price of the products to search for.

Default: null

occasionstring

The occasion for the gift or productExample occasions include: anniversary, birthday, congratulations, get well, graduation, housewarming, Im sorry, just because, love and rommance, new baby, retirement, thinking of you, christmas, valentines day, mothers day, fathers day, new years, winter, fall, spring, summer, graduation

recipient_relationshipstring

The relationship of the recipient of the gift or product. Strict values include: client, colleague, family, other, friend, wife, husband, self, girlfriend, boyfriend, aunt, uncle, grandma, grandpa, sister, brother, daughter, son, dad, mom, 'none_given'.

session_idstring

Frontend session ID for tracking user journey across frontend and backend

zip_codestring

The optional zip code of the location to search for products.

Links

Website Privacy Policy Terms of Service