Book a Comet delivery (account holders)
book_deliveryBook a same-day courier delivery on a Comet account. Call first without confirm to get a preview (price, vehicle, pickup time); show it to your user; then call again with the same details and confirm=true to place the order. Returns the Comet order number. Needs the client's Comet account key (Authorization: Bearer cmt_...). Account holders get one from Comet at (312) 786-2288.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| when | No | 'now' (default) or a pickup time in Chicago time today or tomorrow, e.g. '2026-10-13T09:00'. Further ahead: call the office. | |
| pieces | No | Number of pieces (default 1) | |
| confirm | No | false/omitted = preview only (price and details, nothing booked). true = place the order. Always show the preview to your user before confirming. | |
| service | Yes | Streak (fastest, about 1-2 h), Priority (about 2-3 h) or Standard (about 4-6 h). Only the services on the account are accepted. | |
| vehicle | No | Vehicle wanted; 'auto' (default) picks from the weight. A heavier load is moved up to the vehicle it needs. | |
| reference | No | Client reference / matter number for the invoice | |
| weight_lb | No | Total weight in pounds. Picks the vehicle when none is given. | |
| ordered_by | No | Name of the person the agent is acting for | |
| pickup_zip | No | ZIP code | |
| reference2 | No | ||
| round_trip | No | True when the courier returns to the pickup (default false) | |
| dropoff_zip | Yes | ZIP code | |
| pickup_city | No | City (default Chicago) | |
| pickup_name | No | Company or person at pickup. Omit pickup fields entirely to pick up at the account's own office. | |
| dropoff_city | No | City (default Chicago) | |
| dropoff_name | Yes | Company or person receiving the delivery | |
| notify_email | No | Email for the order confirmation and delivery notice | |
| package_type | No | Default envelope | |
| pickup_notes | No | Instructions for the courier at pickup | |
| pickup_phone | No | ||
| pickup_state | No | Two-letter state (default IL) | |
| pickup_suite | No | Suite / floor at pickup | |
| dropoff_notes | No | Instructions for the courier at drop-off | |
| dropoff_phone | No | ||
| dropoff_state | No | Two-letter state (default IL) | |
| dropoff_suite | No | Suite / floor at drop-off | |
| pickup_street | No | Pickup street address, e.g. '300 N LaSalle St' | |
| dropoff_street | Yes | Drop-off street address, e.g. '300 N LaSalle St' | |
| pickup_contact | No | ||
| dropoff_contact | No |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ok | Yes | ||
| error | No | ||
| pickup | No | ||
| placed | No | True only when a real order was created | |
| status | No | ||
| account | No | ||
| dropoff | No | ||
| message | No | ||
| preview | No | ||
| service | No | ||
| vehicle | No | ||
| request_id | No | ||
| pickup_time | No | ||
| order_number | No | Comet / Xcelerator tracking number once entered, e.g. '516.101226' | |
| estimated_price | No | List-rate estimate; the account's own rate applies on the invoice |