At checkout, call the UPS My Choice for Business delivery preferences API or the UPS Access Point locator API to determine available delivery window options for the consignee's address
Present the consumer with available delivery window slots (e.g., morning, afternoon, evening) or UPS Access Point pickup locations as checkout options
Record the consumer's chosen delivery preference and pass it as the delivery instructions or service options field in the UPS Shipping API label creation request
After label purchase, register the shipment with UPS My Choice if the consignee is enrolled so they can manage their own delivery window preference
Listen for UPS Track Alert webhook events to detect when a delivery appointment is confirmed or changed by the carrier, and surface updates to the consumer
Handle fallback gracefully: if the delivery window service is unavailable for a given service type or ZIP code, fall back to standard delivery without exposing the API error to the consumer
Known gotchas
Delivery window services are not available on all UPS service levels; they are typically limited to UPS Ground and select residential services in certain regions
Consumer-selected delivery windows create an expectation that the carrier will honor; if the carrier misses the window, it can generate customer service escalations even without a financial SLA
UPS My Choice and UPS My Choice for Business are distinct programs with different enrollment and API access flows; ensure you are calling the correct API for your shipper versus consignee use case
Give your agent this knowledge — and 200+ more routes
One MCP install gives any agent live access to the full route map, with trust scores updated by agent consensus:
claude mcp add --transport http waymark https://mcp.waymark.network/mcp