Schedule residential pickup
book_residential_pickupSchedule 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. The order minimum applies (get_pricing). Only ZIPs served by Fold are accepted (see check_service_zip).
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"firstName": "<firstName>",
"lastName": "<lastName>",
"email": "<email>",
"phone": "<phone>",
"line1": "<line1>",
"city": "<city>",
"state": "<state>",
"zipCode": "<zipCode>",
"services": "<services>",
"pickupDate": "<pickupDate>",
"pickupWindow": "<pickupWindow>"
},
"name": "book_residential_pickup"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| city | Yes | City, e.g. "Los Angeles" | |
| Yes | Customer email (used for tracking + receipts) | ||
| line1 | Yes | Street address line 1, e.g. "123 Main St" | |
| line2 | No | Apartment / suite / unit (optional) | |
| notes | No | Optional special instructions about the laundry (e.g. "no fabric softener"). | |
| phone | Yes | Customer mobile: US 10-digit, or E.164 with country code (+1…, +44…) for international guests | |
| state | Yes | US state code, e.g. "CA" | |
| zipCode | Yes | 5-digit ZIP. Must be in service area (use check_service_zip first). | |
| lastName | Yes | Customer last name | |
| services | Yes | What services to perform. | |
| firstName | Yes | Customer first name | |
| pickupDate | Yes | YYYY-MM-DD date for pickup. Must be today or in the future. | |
| deliveryDate | No | YYYY-MM-DD delivery date. Defaults to pickup date + 1 day if omitted. | |
| pickupWindow | Yes | Pickup time window label from check_service_zip.pickupWindows, e.g. "9-11 AM". | |
| deliveryNotes | No | How to find / deliver to the address (gate code, doorman, leave at door, etc.). | |
| deliveryWindow | No | Delivery time window label from check_service_zip.deliveryWindows. EVENING ONLY — Fold does not deliver in the morning. Defaults to the evening window if omitted. | |
| idempotencyKey | No | OPTIONAL — pass a unique identifier (UUID recommended) to make this call safe to retry. If we have already seen this key, we return the EXISTING order code instead of creating a duplicate. Highly recommended for production agents that may retry on network errors. |