1. Log In/Create USPS Business Account

Use the USPS Customer Onboarding Portal (COP), sign into your USPS Business Account, or create a new USPS Business Account. The COP will ensure that your USPS Business Account is configured for the USPS APIs.

2. Create an App

After finishing account setup through the COP, select My Apps on the top of the COP Business Portal page.

3. Retrieve your Consumer Key and Secret 

Within COP, select your App and retrieve your Consumer Key and Consumer Secret from the Credentials section. These credentials are required for generating the OAuth Token.

4. Generate your OAuth Token

Review the OAuth specifications. Pass the Consumer Key and Consumer Secret obtained in Step 4 as the client_id and client_secret, respectively.

5. Try Out USPS APIs

Review the API Catalog for the detailed specifications on the available APIs. All USPS APIs require an OAuth Token to be conveyed in the Authorization header, using the Bearer Token scheme. Please reference the USPS Github page for a repository that contains example Postman requests and Curl commands. To test, please use your production credentials and send requests to the Testing Environment for Mailers (TEM) by changing the base url of the endpoints from "apis.usps.com" to "apis-tem.usps.com".

The default product includes OAuth, Addresses, Domestic Pricing, International Pricing, Locations, Service Standards, Service Standards Files, Shipping Options, and UserInfo, each with a quota of 60 calls per hour. To get started with APIs not included in the default or to request a quota increase, please contact us by submitting a USPS API service request on the Email Us page and a representative will assist.

Note: If you want to use the Labels APIs, it requires additional approval and configuration. The Labels APIs require you to be enrolled in USPS Ship for both outbound and return labels and have an Enterprise Payment Account.  

Contact Us:

If you have questions, please contact us by submitting a USPS API service request on the Email Us page and a representative will assist.

Please include the following information in your service request:

•Your Name
•Company Name
•Contact Phone Number
•Developer Portal Username
•Developer Portal App Name
•URL being called (apis.usps.com, apis-tem.usps.com, api.usps.com, or api-cat.usps.com)
•Consumer Key/client_id
•Customer Registration ID (CRID)
•Mailer ID (MID)
•Country
•ZIP Code

**Do not include Consumer Secret (client_secret)