Skip to content Skip to main navigation Skip to footer

Configure USPS

Opero Ship app supports using USPS, Stamps.com (USPS), and Endicia (USPS) as carriers. Using only USPS allows getting shipment rates and tracking shipments for free (no creating labels), while using Stamps.com (USPS) and Endicia (USPS) allows getting shipment rates, tracking shipments, and creating labels. This article covers the configuration of USPS.

Steps to Configure Carrier

  • Create a USPS Business account.
  • Sign Up for a Business Customer Gateway account using your USPS business account credentials (this will take you to the Business Customer Gateway signup page).
  • Log in to the USPS Developer Portal USPS Developer Portal  (login using credentials from Step 1) using your USPS business account credentials once you have completed signing up.
  • Create an App (Must be logged into USPS Developer Portal): Click the Apps button from the Menu Bar and complete the following steps to create an App:
    • Click “Add app” button
    • Enter “App Name” for your application (required). Important: The app name must be your company name or there will be issues when you try to authorize the app in later steps.
    • Check the box to accept Terms and Conditions, and Privacy Policy
    • Enter “Description” (optional)
    • Select the APIs Available (required)
    • Click “ADD APP” Button
  • Retrieve your Consumer Key and Secret: Select the application you just registered and retrieve your Consumer Key and Consumer Secret from the credentials section. These credentials are required for generating the OAuth token.
  • Authorize Application to Access Protected Information Resources: Navigate to the USPS Customer Onboarding Portal to authorize the client application you registered on the USPS APIs Developer Portal in order to access your information resources shared with the USPS. This includes information resources such as payment accounts, permits, CRID’s, MID’s, and subscriptions.
  • Email webtools@usps.gov to request that they enable the Rate calculator API.
  • Submit a web tools inquiry https://emailus.usps.com/s/web-tools-inquiry to request that they enable the appropriate tracking API. Important Note: Set up of your MID must be completed prior to requesting access or your request will be rejected. A mailer identification number (MID) is a 6 or 9-digit number assigned to a customer through the USPS Business Customer Gateway (BCG). Please refer to the following links for help: https://gateway.usps.com/eAdmin/view/knowledge?securityId=MID o https://postalpro.usps.com/mailing/mailer-id. Please contact the NCSC-Delivery Confirmation (email: Delivery.confirmation@usps.gov; phone: 1-877-264-9693, Option 1) for assistance. In the inquiry form include the following information:
    • Username: Enter your username.
    • WebTools Issue: Select “Tracking API”.
    • Please provide additional details: Select “Access for tracking APIs”.
    • Date of Problem (best guess): Select “Today” date.
    • Additional Information: Provide the following information listed below:
      • Web Tools USERID:
      • Mailer ID:
      • Company Name:
      • Company Website:
      • Requester First and Last Name:
      • Requester Email:
      • Requester Phone number:
      • Mailing Address:
      • Mailing City:
      • Mailing State:
      • Mailing Zip Code:
      • PROD Registration Date:
      • API access requested: Package Tracking
      • Anticipated volume (daily, weekly, monthly, or annually):
      • Are you shipping with USPS?
  • Once the APIs are enabled, open Opero Ship app, go to Ship Configuration page, and click USPS.
  • Check the Active box so that this carrier is an active carrier. 
    • When a carrier is active, you are able to set carrier specific settings in the Create Shipment tab and create/ print active shipping labels. If the Active box is not checked, when you create a shipment, you will not see the carrier specific section for this carrier and you will not be able to create/print shipping labels for this carrier.
  • Copy the Client Key into the Client Id field. Copy the Client Secret to the Client Secret field.