USPS Live Shipping Migration

The USPS Web Tools API platform was retired on January 25, 2026. If your DecoNetwork site is still using a USPS (Legacy) / Web Tools-based connection for live shipping rates, you should migrate to DecoNetwork’s current USPS integration to avoid rate lookup failures at checkout and in Business Hub.

In this article

• Prerequisites
• Why you need to migrate
• Step 1: Confirm whether you’re using USPS (Legacy)
• Step 2: Get your USPS API credentials
• Step 3: Add the current USPS carrier in DecoNetwork
• Step 4: Choose USPS services to offer customers
• Step 5: Remove the USPS (Legacy) connection
• Best-practice tips
• Troubleshooting
• FAQs
• Additional resources

Prerequisites

Why you need to migrate

USPS retired the legacy Web Tools APIs. If your DecoNetwork site is still using a USPS (Legacy) connection (or older Web Tools credentials), USPS live rate requests may fail – resulting in missing shipping options at checkout, inaccurate totals, or manual rate entry.

• Prevent checkout disruptions: keep USPS services available for customers.
• Improve reliability: use the modern USPS API platform with OAuth 2.0 authentication.
• Reduce manual work: fewer “rate not found” scenarios that require overrides.

Step 1: Confirm whether you’re using USPS (Legacy)

1. Log into your DecoNetwork Website.
2. Go to Admin → Settings → Shipping.
3. Select Shipping Methods.
4. Click Manage Live Shipping Carriers.
5. On the Live Shipping Carriers page, look for an entry labelled USPS (Legacy) (or similar). If you see it, you should migrate to the current USPS integration.

Step 2: Get your USPS API credentials

DecoNetwork’s current USPS integration uses the modern USPS API platform, which authenticates using OAuth 2.0. To connect USPS in DecoNetwork, you’ll need a USPS Business Customer Gateway login and an app in the USPS Customer Onboarding Portal (COP), which provides your Consumer Key and Consumer Secret (these are used as your Client ID and Client Secret).

1. Log in (or create) your USPS Business account

   • Go to the USPS Developer Portal “Getting Started” area and click USPS Customer Onboarding Portal (COP).

     

     USPS Developer Portal Getting Started page

   • Sign in using your USPS Business Customer Gateway credentials. If you don’t have one yet, click Create New Account.

     

     USPS Customer Onboarding Portal Login page

   • Enter your email address to begin the account creation process and follow the prompts to validate your email and complete your company/contact details.

     

     USPS Business Account creation.

   • After successful login, you’ll arrive on the COP landing page with your account information.

2. [Optional] Add a Payment Account (label users only)

   If you are only using USPS for live shipping rates in DecoNetwork, you can typically skip this step. Adding a payment account is required for USPS API-based label generation.

   • On the COP landing page, select Add Your Payment Account to Get Started and follow the prompts.
   • If prompted to verify your bank account, USPS may send two micro-debits. Once they appear, return to COP to verify the amounts and complete setup.
   • If you are not adding a payment account, select Skip Payment & Continue to Business Portal.
3. Create an App in COP

   • In COP, go to My Apps.

     

     USPS COP - My Apps.

   • Open Developer Apps.

     

     USPS COP - Developer Apps.

   • Click Add App.

     

     USPS COP - Add App.

   • Enter an App name (required).

   • Tick the Public Access I checkbox (required), then click Add App.

     

     USPS COP - App creation.

   • Confirm the app appears and shows a status of Approved.
4. Retrieve your credentials

   • Next to your app, click Manage.

     

     USPS COP - Manage App.

   • Copy the Consumer Key and Consumer Secret. In DecoNetwork, use these as your Client ID and Client Secret.

     

     USPS Business Account creation.

Step 3: Add the current USPS carrier in DecoNetwork

1. Go to Admin → Settings → Shipping → Shipping Methods.
2. Click Manage Live Shipping Carriers.
3. Click Add Live Shipping Carrier.

4. On the Add Live Shipping Carrier page, click the USPS tile (not USPS Legacy).

   

   Add Live Shipping Carrier: select the current USPS tile (not USPS Legacy).

5. In the details popup, click Connect USPS.

6. On the credentials page, paste your Client ID and Client Secret.

   

   USPS credentials in DecoNetwork: enter Client ID and Client Secret, then test the connection.

7. Click Test settings to confirm the connection is successful.
8. Click Save.

Step 4: Choose USPS services to offer customers

After you’ve successfully connected USPS, enable the specific USPS services (shipping methods) you want customers to see at checkout.

1. On the Live Shipping Carriers page, click Choose Methods for the newly connected USPS carrier. (This button is typically enabled only after a successful test.)

2. Tick the checkbox for each USPS service you want to offer.

   

   Choose Methods: select the USPS services you want to offer, then save.

3. Click Save.

Step 5: Remove the USPS (Legacy) connection

Once the current USPS carrier is connected and returning rates successfully, remove the old USPS (Legacy) connection to prevent confusion and reduce the chance of customers being offered a carrier that may no longer return reliable rates.

1. Return to Admin → Settings → Shipping → Shipping Methods.
2. Click Manage Live Shipping Carriers.
3. Locate the USPS (Legacy) entry.

4. Click Delete Connection (or the delete action for that carrier) to remove the legacy integration.

   

   After migrating, delete the USPS (Legacy) connection to avoid future disruptions.

Best-practice tips

Troubleshooting

Real-time USPS rates are not appearing

• Confirm USPS is connected using the current integration (OAuth credentials), not USPS (Legacy).
• Re-open the USPS carrier and click Test settings to confirm credentials are valid.
• Check product weights (and dimensions if used) are entered correctly.
• Confirm your dispatch/origin address is complete and valid (ZIP/postcode, state, country).
• Try enabling at least one common USPS service in Choose Methods, then save and retest checkout.

The “Choose Methods” button is disabled

• Run Test settings for the USPS carrier and ensure it succeeds.
• Click Save after testing – methods typically can’t be selected until the connection is saved successfully.

USPS (Legacy) still shows in my carriers list

• This can happen for accounts that previously configured legacy USPS.
• After confirming the current USPS carrier is working, use Delete Connection on the legacy entry.

FAQs

Do I need to create a new USPS account?

Not necessarily. If you already have a USPS account, you can usually keep it. However, you must still obtain the correct USPS API (OAuth) credentials (Client ID / Client Secret) from the USPS Developer Portal.

Can I reuse my USPS Web Tools User ID?

No. Web Tools credentials are not the same as USPS API OAuth credentials. The current USPS integration requires a Client ID and Client Secret.

Will this affect live shipping in Business Hub?

Yes – any place DecoNetwork retrieves USPS live rates (website checkout and Business Hub order creation) relies on the configured carrier connection. Migrating ensures USPS live rates continue working across your workflow.

Additional resources

• Connect with USPS for live shipping estimates
• To add live shipping methods for a live shipping carrier
• Add live shipping methods
• Set up live shipping methods