Shipping
Connect USPS to Wilph
USPS Developer Portal credentials let Wilph read tracking and delivery status for domestic USPS mail.
- Roughly how long
- About 15 minutes
- Who can do it
- Anyone with a USPS business account.
Before you start
- A USPS.com business login.
Step by step
Register an app on the USPS Developer Portal
Sign in at developer.usps.com, open Apps, and add one. USPS calls the resulting pair OAuth client credentials.
Add the Tracking API to the app
APIs are subscribed to per app. An app with no Tracking subscription authenticates fine and then returns nothing.
Copy the consumer key and consumer secret
Both are shown on the app's page. The secret is the one Wilph encrypts.
Paste them into Wilph
In Wilph, open Dashboard → Integrations → USPS → Connect and save both values.
What Wilph asks for
The exact fields on the connection form, in order.
- Consumer key
From the app you register in the USPS Developer Portal.
- Consumer secretStored encrypted
Issued with the consumer key. USPS calls this pair OAuth client credentials.
The consumer secret is encrypted before storage.
Register a USPS Developer Portal app ↗If something goes wrong
Authentication succeeds but every lookup is empty.
The app almost certainly has no Tracking API subscription. Add it on the portal and try again.
The credentials stopped working after a while.
USPS retires unused apps and rotates credentials on request. Check the app is still active on the portal.
Still stuck? Get in touch — tell us which step it failed on and what it said.
More shipping guides
Ready to connect USPS?
Open Integrations in your Wilph dashboard and paste in what you collected.