Place a pickup order
biz_orderPlaces a pickup pre-order at a business served through this connector: placing an order, a pickup order, or the checkout after biz_menu. Needs items (id and qty) and a pickupWindowId from biz_menu, and the first name of the person collecting. It takes a first name and an optional short note and nothing else: no phone number, email address, surname or card is collected, and the note is scrubbed of contact details on the server. On success the order is in the book and the pickup window is one order fuller. PAYMENT: on most businesses nothing is charged and the order is paid in person at pickup. On a business whose payment lane is on, the reply has orderState HELD and a payUrl of the form https://sonarconnections.com/p/: the order is not placed yet, the pickup window is held for ten minutes, and the order is placed only when that link is paid. That payUrl, exactly as returned, is the only payment link this connector issues, and it stops working the moment the hold releases, the order is paid or the order is cancelled. Pickup only, no delivery and no shipping. Businesses served here: Long Beach Brunch Bakehouse (longbeachbrunch, a neighborhood bakery and coffee bar). Reachable here but not through this tool: Velvet and Clay (velvetandclay), Brightpoint Dental (brightpointdental), Make Collectives (makecollectives) and Kristin Dunn Bookbinding and Design (kdbooks) take no pickup orders. A business that takes no orders returns an explanation with its hours instead. An order can be refused for a real reason (an item that is sold out, a quantity outside its limits, a full or past pickup window, or an item that needs more notice than the window gives), and the refusal says which and offers other times. When the reply's isDemo is true the business is a demonstration and nothing is reserved in the physical world. The business may be given by name or by id: "Long Beach Brunch Bakehouse" and "longbeachbrunch" both reach the bakery, and a common short form ("the bakehouse", "the brunch house", "the dentist") works too. A name that matches no business served here is refused with the list of businesses that are served, and is not answered about a different one.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| note | No | Optional short preparation note, 140 characters, e.g. "no nuts" or "happy birthday Ada". Contact details are removed server side: this is not a message channel. | |
| items | Yes | The order lines. At least one. | |
| business | No | Which business, BY NAME OR BY ID. Available: Long Beach Brunch Bakehouse (longbeachbrunch). The default (velvetandclay) takes no pickup orders, so NAME THE BUSINESS: an omitted argument is refused. A common short form works too ("the bakehouse", "the dentist"). A name that does not clearly match one of these is REFUSED with the list, and it is not answered about a different business. | |
| firstName | Yes | First name only. No surname, phone number or email address. | |
| businessId | No | Alias for `business`, accepted because every reply carries this name. Takes a NAME OR AN ID, exactly like `business`. Ignored when `business` is also given. | |
| pickupWindowId | Yes | A window id from biz_menu, e.g. 2026-09-10T10:00 |