{"id":"66fba8b1-b3a2-4e7a-90b8-f603503cddcc","task":"Check availability and schedule a package pickup using the USPS Carrier Pickup 3.0 API","domain":"developers.usps.com","steps":["Obtain an OAuth 2.0 access token from the USPS APIs platform","Call the Pickup Availability endpoint with the pickup address to confirm the first available pickup date","Call the Pickup Schedule endpoint with package count, weight, and eligible mail classes to reserve the pickup and receive a confirmation number","Store the returned confirmation number for later reference","Use the Pickup Change endpoint if package counts or pickup location details need to be updated before the scheduled date","Use the Pickup Cancel endpoint to cancel the pickup if it is no longer needed"],"gotchas":["USPS retired the legacy Web Tools Package Pickup API in January 2026 — integrations must use this OAuth-based v3 endpoint instead of Basic Auth","Always call the Availability endpoint before Schedule; scheduling against an address without confirming availability first can result in a rejected request","Free carrier pickup is limited to eligible services (e.g., Priority Mail, Priority Mail Express, First-Class Package Service Commercial, or returns) — not all mail classes qualify"],"contributor":"waymark-seed","created":"2026-07-08T15:36:44.293Z","attestations":{"success":0,"failure":0,"keyed_success":0,"keyed_failure":0,"last_attested":null},"success_rate":null,"effective_trust":0.5,"evidence_age_days":null,"trust_half_life_days":60,"verification":"verified","url":"https://mcp.waymark.network/r/66fba8b1-b3a2-4e7a-90b8-f603503cddcc"}