Skip to main content

USPS

Connect your USPS account to TrackShip

Written by Brijesh

To continue tracking USPS shipments reliably, you can connect your USPS account to TrackShip.
​
Due to recent USPS policy changes (effective April 1, 2026), connecting your USPS account ensures uninterrupted tracking and improved performance.

:point_right: Who should do this? Who should do this?

You should connect your USPS account if:

  • You generate USPS shipping labels directly

  • You have a USPS Business / Web Tools account

:white_check_mark: Why connect your USPS account?

  • Faster and more reliable tracking updates

  • Improved delivery status accuracy

  • Avoid potential tracking interruptions

:gear: Step 1: Get your USPS credentials
​
1. Go to the USPS Customer Onboarding Portal (COP):
​https://cop.usps.com/cop-navigator?wf=API&showCC=false or https://gateway.usps.com
2. Log in with your USPS account (or create one)
3. Once logged in, go to My Apps
4. Select your app and open the Credentials section
5. Copy: Consumer Key & Consumer Secret

This usually takes just a few minutes.

6. Submit an IP Agreement with USPS (Required - most commonly missed step)

⚠️ CRITICAL: Without this step, you will get a "Unknown" error even after adding credentials to TrackShip.

Option A: Email (Recommended)

  1. Go to: https://emailus.usps.com/s/usps-APIs

  2. Submit an IP Agreement inquiry

  3. State: "I need to authorize my USPS account for tracking API access under the new April 1st, 2026 requirements for use with TrackShip."

  4. Include your USPS account username/MID

Option B: Phone

  1. Call: 1-(877)-672-0007

  2. Press option #6 (API Access Control), Then press option #2

  3. Request: "Authorization for my USPS account to access the tracking API under the new April 1st requirements"

Timeline: USPS typically processes IP Agreement requests within 1-3 business days. You'll receive an email confirmation from USPS when approved.

:gear: Step 2: Add your USPS account to TrackShip
​
1. Go to your TrackShip dashboard
2. Navigate to Settings → Carriers
3. Click Add USPS Account
4. Paste your credentials: ​Consumer Key & Consumer Secret
5. Click Save

:warning: Important note

  • Your credentials are used only to access tracking data securely

  • TrackShip does not modify your USPS account or shipments

:question: Need help?
​If you’re unsure whether this applies to you, or need help finding your credentials:
​

:point_right: Contact us, and we’ll guide you step-by-step
​

:blue_book: More details
​
You can read the official USPS update here:
​https://postalpro.usps.com/node/14702

🚢 Special Cases: Third-Party Shipping Platforms

I use PirateShip

Issue: PirateShip users don't have individual USPS credentials - PirateShip brokers USPS access for you.

Solution: We're actively working on a solution for PirateShip users. You'll receive an email when an alternative solution is ready. Your shipments are still being delivered - only tracking visibility in TrackShip is temporarily affected.

Alternative: You can still track USPS shipments manually at usps.com using your tracking numbers.

I use ShipStation, Stamps.com, or WooCommerce Shipping

Two scenarios:

Scenario A: Platform uses YOUR USPS account

  • Follow the steps above (Step 1 + Step 2)

  • Use the same USPS credentials you connected to ShipStation/Stamps.com/WooCommerce Shipping

Scenario B: Platform brokers USPS for you (you don't have individual USPS credentials)

  • Contact [email protected]

  • We can set up platform API integration as an alternative solution

Not sure which applies to you? Reply to any TrackShip email and we'll help you figure it out!

I use EasyPost, GoShippo, or other platforms

Solution: Most platforms either:

  • Use YOUR USPS account (follow Steps 1 + 2 above), OR

  • Broker USPS access (contact [email protected] for alternative integration)

If you're unsure which applies to you, contact [email protected] and we'll guide you through the right setup.

I dropship / use a 3PL warehouse

Question: Does your dropshipper/3PL use your USPS account, or their own?

  • If they use YOUR account: Follow Steps 1 + 2 above

  • If they use THEIR account: Contact [email protected] - we'll need to coordinate with your dropshipper/3PL for API access

Did this answer your question?