Authenticate with a UPS OAuth 2.0 bearer token scoped to freight operations using your client_id and client_secret
POST a freight rate request to the UPS Freight Rating endpoint with origin and destination ZIP codes, freight class, total weight, and number of handling units to retrieve a quote
Build the freight shipment request body with shipper, receiver, and bill-to party information, commodity description, NMFC code, freight class, weight, and number and type of handling units
POST to the UPS Freight Shipping endpoint to create the shipment; the response includes a PRO number and a base64-encoded bill of lading PDF
Decode and store the bill of lading PDF; provide it to the driver at pickup and email it to the consignee as advance shipping documentation
Schedule a pickup by including the pickup request fields in the freight shipment call or by calling the UPS Pickup API separately with the PRO number and desired pickup date and ready time
Known gotchas
UPS Freight API requires a separate account number from your parcel account; ensure the correct freight account number is included in the API request
Freight class must be determined before booking; UPS reserves the right to re-weigh and reclassify freight at the terminal, which can result in significant invoice adjustments if the declared class is wrong
Bill of lading terms (prepaid, collect, third-party billing) must be correctly specified in the API request; errors in billing terms can result in payment disputes and shipment holds
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