Fold Laundry

Activate a paid Semester Pass — the student supplies their phone (for pickup-day reminders), dorm building + room, and their CHOSEN PICKUP DAY (one of the campus's availablePickupDays from list_campuses). Only callable on a pass in PENDING_ACTIVATION status (i.e. payment has cleared). After activation, weekly pickup Orders auto-generate on the chosen day until the term ends. Activation is idempotent — re-calling on an already-ACTIVE pass is a no-op.

Apply a promo / discount code to an existing order. Promo codes can only be applied to orders still in DRAFT or SCHEDULED state — before pickup. Requires order code, email, and the promo code (typically 4–12 alphanumeric, e.g. "WELCOME10" or "REF-AB12"). Returns the new total and the discount applied.

Requires the connected Fold account of front-desk staff at a Fold partner hotel (the login must belong to the hotel's Fold business account). Books laundry pickup for a guest by room number at that hotel. billTo='hotel' (default) puts the order on the hotel's monthly Fold statement so the hotel can charge the guest's folio: no card link is sent and no card is charged. billTo='guest' sends the guest the usual card link instead and is priced at the hotel guest rates (see book_hotel_pickup); billTo='hotel' orders are priced on the hotel's Fold contract rates, with the same $49.99 hotel order minimum. Guest name, email and phone are still needed for status updates. returnPreference: same_day (bag at the desk before 9 AM), express_same_day (9 AM–noon, +$30), next_day, or flexible. This creates a real order.

Schedule a laundry pickup for a hotel guest. Creates an order without requiring a Fold account. Returns an order tracking code (FHL-XXXXXX) and a Stripe payment-setup URL. The user must visit the Stripe URL to enter their card before pickup. The card is NOT charged at booking — only after intake when the actual price is known. Hotel guest pricing: wash & fold is $49.99 flat for up to 15 lb, then $2.65/lb over 15 lb; dry cleaning is priced per garment. $49.99 hotel order minimum (covers wash & fold and dry cleaning — smaller orders are billed at $49.99). A flat $9.99 hotel service charge is added to every hotel booking on top of that, and the $30 Express surcharge (when chosen) is also on top — neither counts toward the minimum. Return-time tiers: • same_day — guest must drop the bag before 9 AM Pacific. Standard same-day return (back by 8 PM), no surcharge. Covers wash & fold AND dry cleaning. • express_same_day — drop between 9 AM and 12 PM. ⚡ Express same-day (back by 8 PM tonight). $30 flat surcharge. • next_day — drop any time. Standard next-day return (back by 8 PM tomorrow). No surcharge. Most common choice. • flexible — 48+ hours. No surcharge. Same-day options are not available after 12 PM Pacific time (Los Angeles / San Francisco); requests after noon are next_day or later. The server enforces these cut-offs on its own clock: a same_day request between 9 AM and noon is refused with a message to use express_same_day (+$30) — confirm the $30 with the guest before retrying — and any same-day request after noon is refused (use next_day). It never adds a surcharge or changes the day silently.

Requires the customer's connected Fold account. Books a pickup at one of their SAVED addresses using their saved card, gate code / access notes and laundry preferences — no payment link needed. Omit addressId to use their default address. pickupWindow must be one of the market's windows; if it is missing or invalid the response lists the valid windows and nothing is booked. Delivery is the next evening by default (Fold delivers in the evening only). sameAsLastOrder=true reuses the service, address and pickup window of the customer's most recent order (or of sameAsOrderCode, e.g. from a receipt); anything passed explicitly overrides it. This creates a real order. An optional idempotencyKey (UUID) makes retries return the same booking instead of creating a second one.

Schedule a laundry pickup at a residential address. For any non-hotel address in the service area, including Airbnb and other vacation rentals (the rental address is the pickup address). Creates a guest customer account (no password needed — they can claim it later by signing up with the same email). Returns an order code (FOLD-XXXXX) and a Stripe payment-setup URL. The card is NOT charged until after intake. $39.99 order minimum applies. Only ZIPs served by Fold are accepted (see check_service_zip).

Buy a Fold Semester Pass for a college student at UCLA, USC, UC Berkeley, or UCSF. The PURCHASER (often a parent) provides their own name + email for the receipt, plus the student's name + email. Returns a Stripe Checkout URL — the purchaser must visit it to complete payment. Once paid, the student gets a separate email with an activation link to fill in their dorm details. campusId, termId and pricing come from list_campuses. Pricing varies by campus and term; the response echoes the priceCents.

Cancel a Fold order. Allowed only before the driver has picked up the bag — after pickup, items have to be returned unprocessed instead (the customer should call support). Requires the order code and the email used at booking. Returns the new state and confirms the saved card was not charged.

Check whether Fold serves a given ZIP code. Returns service availability, the market name (LA/SF), and a list of pickup window options that can be passed to book_residential_pickup. book_residential_pickup only accepts ZIPs this tool reports as served.

Enroll a Fold customer in Fold Club. Requires a recent order code + email for identity (same auth model as track_order). The customer MUST have a saved card on file — if not, we return an error pointing them to /app/payment. Three plans: WF_CLUB (Wash & Fold $19.99/mo or $219.89/yr), DC_CLUB (Dry Cleaning $12.99/mo or $142.89/yr), ALL_IN (Wash & Fold + Dry Cleaning $29.99/mo or $329.89/yr). Annual billing: 1 month free (pay for 11 months). The card is charged immediately and the plan renews automatically (every month, or every year for ANNUAL) at that price until cancelled; cancel any time in the app (Account → Fold Club) — the plan then runs to the end of the paid month/year with no refund for unused time. Before calling this tool, tell the customer the exact amount, that it renews automatically, and how to cancel, and get their explicit yes. promoCode WELCOME gives the first month free on MONTHLY billing only (it is typically sent to customers by SMS/email after their first delivery); promo codes are rejected on ANNUAL.

Requires the connected Fold account, and only returns data when that login belongs to a Fold business (B2B) account such as a hotel, office or property-management company. For each such account: this month's deliveries and running total, the last three months' statement totals, payments, balance and due date, an open invoice payment link if one exists, and the scheduled delivery days. Read-only.

Calculate an itemized price estimate for what the user actually wants — bags or pounds of wash & fold plus dry-cleaning garments named in plain words (e.g. '2-piece suit', 'dress shirt', 'winter coat'). Answers 'how much will it cost' before booking. Returns line items, subtotal, and total in cents and USD (no hidden fees; orders under the $39.99 minimum are billed at the minimum). Note: the actual charge is calculated at intake when bags are weighed, but this estimate is accurate to within ~10% for typical orders. These are residential prices — hotel guest orders are priced differently (see get_pricing hotelGuestRates).

Returns Fold's linen-turnover program for Airbnb / Vrbo / short-term rental hosts: how same-day turnovers work, pricing by host size (à la carte, Fold Club, portfolio volume rates), and how to get started. Use when the user hosts a short-term rental, manages STR properties, or asks about linen/turnover service between guests.

Only call this when the customer asks about their own Fold account, saved details or orders — it requires their connected Fold account and asks them to sign in. Prices, ZIP coverage, estimates and guest bookings work without signing in (get_pricing, check_service_zip, get_estimate, book_residential_pickup). Returns their saved addresses (with gate code / access notes), whether a card is on file, Fold credit balance, Fold Club membership, laundry care preferences (detergent, water temperature, special instructions) and recurring pickups. book_my_pickup uses these saved details.

Returns current Fold pricing for all services. A quick rate-card overview; itemized totals for a specific order come from get_estimate. Prices are in USD.

Itemized receipt for an order: items, subtotal, fees, discounts, credits, tax and total, plus payment status. Before intake the items are not known yet and the total is an estimate. Works with the connected account, or order code + booking email.

Look up a customer's Fold referral code and share link. Use this when the customer wants to share Fold with a friend or check how many people they've successfully referred. Returns the code, a ready-to-paste link (foldlaundry.com/r/CODE), and stats. Both sides get $25 in credit after the friend completes their first pickup.

Look up a Fold Semester Pass by code (FSP-XXXXXX). Returns current status, campus, term, dorm details (if claimed), and whether it's ready for pickups. Use this for "is my pass active yet?" or "what's the status of FSP-XXXXXX?" inquiries.

Returns service area, hours, contact info, and key policies. Use this when the user asks "where do you serve?" or for a general overview.

Adds an email address to Fold's waitlist for a ZIP code Fold doesn't serve yet; Fold emails if service starts there. Only for unserved ZIPs (served ZIPs return an error saying Fold already serves them). Use the person's own email with their permission.

List the campuses where Fold offers a Semester Pass (prepaid weekly laundry pickup for college students). Returns four campuses — UCLA, USC, UC Berkeley, UCSF — each with their available terms (e.g. "Fall 2026"), the weekly pickup day, and pricing for both weekly and bi-weekly cadence. buy_semester_pass takes a campusId and termId from this list. Prices are in USD.

List the customer's recent Fold orders (most recent first, max 10). If the customer has connected their Fold account to this assistant, returns each order's code, status, dates and address — no email needed. Without a connected account, only says how many recent orders exist (order codes are never revealed from an email alone, for privacy) — use the order code from the customer's confirmation text/email with track_order, or ask them to connect Fold.

Records the customer's 1–5 star rating and optional comment for a delivered Fold order (rating again replaces the earlier one). Works with the connected account, or order code + booking email. For a high rating the response includes Fold's public review link the customer may choose to use; for a low rating it notes that report_issue opens a support case (re-clean, damage, missing item).

Open a support case for an order (damaged / missing / wrong item, stain not removed, late delivery, re-clean, other). Works with the connected Fold account, or with order code + the email used at booking. A Fold specialist follows up by text or email; re-cleans are free. Describe what happened in the customer's words.

Move the pickup date/window, delivery date/window, or both, on an existing order. Pickup can only be moved while still in SCHEDULED or PICKUP_ASSIGNED (i.e. driver has not started). Delivery can be moved any time before the delivery driver is en route. Requires order code + email. Pass at least one leg.

Requires the connected Fold account. For short-term-rental hosts: schedules linen pickups for several guest checkouts at once across the host's saved addresses (up to 10). Each item: addressId (from get_my_account), checkoutDate (pickup day), pickupWindow, optional nextCheckInDate (return day; default the day after checkout) and notes. With confirm=false (default) nothing is booked: the response previews every item and flags problems. With confirm=true each valid item is booked as a real order on the card on file (same rules as book_my_pickup). Returns are in the evening; same-day turnovers rely on a second linen set at the property.

Search for a hotel by name within Fold service areas (Los Angeles and San Francisco). Returns up to 6 hotels matching the query with their place IDs (used in book_hotel_pickup) and addresses. book_hotel_pickup requires one of these hotelPlaceIds.

Requires the connected Fold account (with a saved address and card). Creates a standing pickup — e.g. every Tuesday — at the customer's default address. Fold books each pickup a few days ahead; the customer can skip or pause any time. This creates real recurring orders.

For agents that can receive webhooks: registers an https URL that Fold POSTs to on every status change of one order (picked up, washing, out for delivery, delivered…). Payload: {event:"order.status_changed", orderCode, state, statusLabel, statusDescription, occurredAt}. Header Fold-Signature: t=<unix>,v1=<hex HMAC-SHA256 of "t.body" with the returned secret>. Works with the connected account or order code + booking email. Max 3 per order.

Check the status of any Fold order — works for both hotel-guest pickups and residential pickups. Needs the order code (FOLD-XXXXXX or FHL-XXXXXX) plus the email used at booking; with a connected Fold account the email is not needed. Returns current state, a milestone timeline, scheduled dates, items if itemized, and proof-of-delivery photo URL if delivered.

Requires the connected Fold account. Saves how a driver gets in at one of the customer's saved addresses: gateCode (gate / building / lockbox code), howToGetIn (buzzer, doorman, side entrance), whereToLeaveBag. Drivers see these on every pickup and delivery there. Omit addressId for the default address. Pass an empty string to clear a field.

Requires the connected Fold account. Saves standing laundry preferences applied to every future order: detergent (eco_unscented = unscented eco, free & clear, the default; or tide), waterTemp (mixed = standard: colors cold, whites warm, the default; cold; warm; hot), and specialInstructions (free text the facility sees on every order, max 500 chars; pass an empty string to clear). Only the fields you pass change.

Requires the connected Fold account. Turns Fold's order-status text messages on or off (orderTexts: picked up, out for delivery, delivered; when off, the same updates arrive by email) and marketing emails on or off (marketingEmails). Only the fields passed change. Returns the resulting settings.

Requires the connected Fold account. action: pause (optionally until a YYYY-MM-DD date), resume, or cancel a recurring pickup (recurringId from get_my_account).