Schedule a carrier pickup for a prepared shipment via carrier API to arrange driver collection from a shipper location

Verified steps

1. Understand pickup API availability: FedEx, UPS, DHL Express, and USPS all offer pickup scheduling via their REST APIs; EasyPost also provides a Pickup object that wraps carrier pickup APIs. Choose the appropriate integration path based on your carrier mix.
2. For EasyPost Pickup: POST to the pickups endpoint with 'address' (pickup location), 'shipments' (array of shipment IDs to be picked up), 'min_datetime' and 'max_datetime' (desired pickup window), and 'is_account_address' (boolean); receive a 'Pickup' object with 'pickup_rates' per carrier; buy the pickup by POSTing to the pickup's buy sub-resource.
3. For UPS Pickup REST API: POST to the UPS Pickup endpoint (verify current path in docs) with 'PickupCreationRequest' containing 'RatePickupIndicator', 'Shipper' (account number and address), 'PickupDateInfo' (pickup date and earliest/latest ready times), and 'PickupAddress'; the response includes a 'PRN' (Pickup Request Number) for confirmation.
4. For FedEx Pickup REST API: POST to the FedEx Pickup endpoint (verify current path in docs) with 'associatedAccountNumber', 'originDetail' (pickup address and ready/company close times), 'packageCount', 'totalWeight', and 'serviceCategory'; receive a 'pickupConfirmationCode'.
5. Store the pickup confirmation number or PRN and surface it to the shipper; this number is needed to cancel or modify the pickup if plans change.
6. Cancel pickups via the respective carrier's cancel pickup endpoint if the shipment is not ready; failure to cancel and missing repeated pickups may result in carrier fees or restrictions.