Skip to main content

USPS

Alert

USPS requires proper package dimensions and weight for accurate rate calculation. Incorrect measurements may result in additional charges.

Requirements​

  • USPS Web Tools Account
  • Valid Business Address
  • Business Phone Number
  • Email Address
  • USPS Permit (for Commercial Shipping)
  • Mailer ID (for Commercial Shipping)

Integration Steps​

Details
Step 1: Create Account
  1. Visit USPS Web Tools registration
  2. Complete the registration form
  3. Verify email address
  4. Accept terms of service
  5. Save account credentials

Create USPS Account

Details
Step 2: Get API Access
  1. Log into USPS Web Tools account
  2. Request API access credentials
  3. Select required API services
  4. Generate User ID and Token
  5. Save API credentials
Details
Step 3: Connect to Piyovi
  1. Open Piyovi dashboard
  2. Go to Settings → Carriers → Add New
  3. Choose USPS integration
  4. Enter USPS credentials
  5. Test the connection

Services​

ServiceDelivery TimeDescriptionCoverage
Priority Mail Express1-2 business daysOvernight to 2-day deliveryUS domestic
Priority Mail1-3 business daysStandard priority shippingUS & territories
First-Class Mail1-5 business daysEconomical lightweight shippingUS domestic
USPS Ground2-8 business daysCost-effective ground serviceContinental US

Support & Contact​

Support TypeAvailabilityContact Details
Customer Support24/7 Support1-800-ASK-USPS
Technical SupportBusiness Hourswebtools@usps.gov
Developer Portal24/7 AccessUSPS Web Tools

Common Errors​

Error CodeDescriptionSolution
Auth ErrorInvalid User IDVerify Web Tools credentials
Address ErrorInvalid address formatCheck address formatting
Rate ErrorInvalid package detailsVerify weight and dimensions

Service Limitations​

CategoryLimitationDetails
Package WeightMaximum 70 lbs31.75 kg
Package SizeMaximum Length108 inches
Package SizeCombined Size130 inches (length + girth)
ProhibitedHazardous MaterialsSee USPS restricted items list
ProhibitedFirearmsSpecial licensing required

Features​

Tracking & Monitoring​

FeatureDescription
Tracking APIReal-time tracking updates
Delivery ConfirmationProof of delivery
Estimated DeliveryCalculate delivery dates

Documentation & Labels​

FeatureDescription
Label GenerationCreate USPS shipping labels
Address ValidationVerify and standardize addresses
Customs FormsInternational shipping forms