How to connect USPS v2

Discover here how to connect your USPS v2 account to ShippyPro!

 

Summary:

  1. Before you start

  2. Connection steps

  3. Supported services
  4. Additional options

  5. Troubleshooting & Errors

 

 

1. Before you start

 To connect the carrier, you need to first ask your USPS Sales Person for credentials such as Client ID, Client Secret, Account Number, CRID, MID, and Manifest MID.

2. Connection steps

Then you can insert the credentials in the Carriers page, clicking on the USPS logo.

If you can't figure how to do it try to take a look at the following example:

 

Screenshot 2024-07-12 alle 10.02.13

3. Supported services

 

Parcel Select > Reliable delivery for packages weighing up to 70 lbs.

Parcel Select Lightweight > Cost-effective delivery for lightweight parcels weighing less than 1 lb.

USPS Connect Local > Fast local delivery for same-day or next-day service.

USPS Connect Regional > Efficient regional delivery service.

USPS Connect Mail > Convenient service for mail delivery.

USPS Ground Advantage > Affordable ground delivery service for packages weighing up to 70 lbs.

USPS Connect Same Day > Same-day delivery service for urgent packages.

USPS Connect Next Day > Next-day delivery service for time-sensitive packages.

Priority Mail Express > Fastest domestic service for delivery within 1-2 days.

Priority Mail > Reliable and affordable service for delivery within 1-3 business days.

First-Class Package Service > Economical service for packages weighing up to 15.99 oz.

Library Mail > Special mailing service for educational materials.

Media Mail > Cost-effective service for shipping media items.

Bound Printed Matter > Economical service for bound printed materials.

Domestic Matter for the Blind > Free mailing service for the visually impaired.

 

Carrier Options

  • 365 - Global Direct Entry

  • 415 - USPS Label Delivery Service

  • 480 - Tracking Plus 6 Months

  • 481 - Tracking Plus 1 Year

  • 482 - Tracking Plus 3 Years

  • 483 - Tracking Plus 5 Years

  • 484 - Tracking Plus 7 Years

  • 485 - Tracking Plus 10 Years

  • 486 - Tracking Plus Signature 3 Years

  • 487 - Tracking Plus Signature 5 Years

  • 488 - Tracking Plus Signature 7 Years

  • 489 - Tracking Plus Signature 10 Years

  • 810 - Hazardous Materials - Air Eligible Ethanol

  • 811 - Hazardous Materials - Class 1 – Toy Propellant/Safety Fuse Package

  • 812 - Hazardous Materials - Class 3 - Flammable and Combustible Liquids

  • 813 - Hazardous Materials - Class 7 – Radioactive Materials

  • 814 - Hazardous Materials - Class 8 – Air Eligible Corrosive Materials

  • 815 - Hazardous Materials - Class 8 – Nonspillable Wet Batteries

  • 816 - Hazardous Materials - Class 9 - Lithium Battery Marked Ground Only

  • 817 - Hazardous Materials - Class 9 - Lithium Battery Returns

  • 818 - Hazardous Materials - Class 9 - Marked Lithium Batteries

  • 819 - Hazardous Materials - Class 9 – Dry Ice

  • 820 - Hazardous Materials - Class 9 – Unmarked Lithium Batteries

  • 821 - Hazardous Materials - Class 9 – Magnetized Materials

  • 822 - Hazardous Materials - Division 4.1 – Mailable Flammable Solids and Safety Matches

  • 823 - Hazardous Materials - Division 5.1 – Oxidizers

  • 824 - Hazardous Materials - Division 5.2 – Organic Peroxides

  • 825 - Hazardous Materials - Division 6.1 – Toxic Materials

  • 826 - Hazardous Materials - Division 6.2 Biological Materials

  • 827 - Hazardous Materials - Excepted Quantity Provision

  • 828 - Hazardous Materials - Ground Only Hazardous Materials

  • 829 - Hazardous Materials - Air Eligible ID8000 Consumer Commodity

  • 830 - Hazardous Materials - Lighters

  • 831 - Hazardous Materials - Limited Quantity Ground

  • 832 - Hazardous Materials - Small Quantity Provision (Markings Required)

  • 857 - Hazardous Materials

  • 910 - Certified Mail

  • 911 - Certified Mail Restricted Delivery

  • 912 - Certified Mail Adult Signature Required

  • 913 - Certified Mail Adult Signature Restricted Delivery

  • 920 - USPS Tracking Electronic

  • 921 - Signature Confirmation

  • 922 - Adult Signature Required

  • 923 - Adult Signature Restricted Delivery

  • 924 - Signature Confirmation Restricted Delivery

  • 925 - Priority Mail Express Insurance

  • 930 - Insurance <= $500

  • 931 - Insurance > $500

  • 934 - Insurance Restricted Delivery

  • 955 - Return Receipt

  • 957 - Return Receipt Electronic

  • 981 - Signature Requested (PRIORITY_MAIL_EXPRESS only)

  • 986 - PO to Addressee (PRIORITY_MAIL_EXPRESS only)

  • 991 - Sunday Delivery

To add these options to your shipment, you need to write the corresponding numbers in the designated section when choosing the carrier, separated by a comma (eg: 924, 955).

 

If you are shipping with API, you need to add the following CarrierOption:

Adding the values separated by a comma.

 

4. Additional Options

Besides your credentials, you'll also see some further options, let's take a look at them!

Label Type gives you the possibility to choose the correct label format for your printer.

Test Mode lets you make some test shipments.

The "Test Mode" option should be flagged only if you have test credentials, not production ones!

If you want, you can also enter a Custom Label to recognize the connection among all the others.

Parcel Type allows you to specify the type of parcel you are shipping.

 

5. Troubleshooting & Errors

Internal Server Error

Check if your USPS connection is in Test Mode.

State not transmitted

Ensure to fill the "State" field for both origin and destination addresses.

invalidApiKey: The client application credentials provided in the request are missing, invalid, inactive or not approved for access.

If your credentials appear to be invalid, create the account going to the getting started page and submit the App creation Form.

 

The requested payment information is not authorized to access /payment-authorization.

 

The user credentials associated with this app are not associated with a payment account.

The ability to use the new USPS API platform to generate labels is predicated on your being enrolled in our latest payment platform, USPS Ship. If you plan on generating labels, you must be enrolled in USPS Ship prior to sending requests to our APIs.

Please complete the following steps to get enrolled in USPS Ship Outbound and Returns.

  • Add a payment account:

 
  • Complete Step 5 on the “Getting Started” page.

    Authorize App to Access Protected Information Resources

    Enter your Consumer Key here to authorize your App to access your payment accounts, permits, CRIDs, MIDs, and subscriptions, which will be required by several USPS APIs.

  • After you have completed all the steps, you should be enrolled in USPS Ship Outbound and Returns.