# Set up USPS
URL: https://support.starshipit.com/articles/5767391395855-set-up-usps
Canonical: https://support.starshipit.com/articles/5767391395855-set-up-usps
Markdown: https://support.starshipit.com/articles/5767391395855-set-up-usps.md
Updated: 2026-10-26

> For the complete documentation index, see [llms.txt](https://support.starshipit.com/llms.txt).

> Connect USPS through EasyPost or USPS Direct API, configure account settings, and add product codes.

Starshipit can connect to USPS through EasyPost or the USPS Direct API. Use the setup route that matches the credentials issued for your account. This guide covers the connection settings and the product codes you can add.

## Before you begin

For the EasyPost setup route, you need an [EasyPost account](https://www.easypost.com/signup). For the Direct API route, you need your USPS enterprise account details and authorisation for Starshipit. Direct API labels support US domestic shipments only; the international services below apply to EasyPost.

## Set up USPS through EasyPost

1. In Starshipit, navigate to **Settings** > **Couriers** > **USPS**.  
   Please note your shipping from country will need to be United States.
2. Tick Enable **USPS**.
3. Enter your **EasyPost API Key**.
4. Enter your **EasyPost USPS Account ID**.
5. Click **Save**.
6. Click **Test to ensure it works** to check your credentials.
7. Add your USPS Product codes.

## USPS products available through EasyPost

When using USPS with Starshipit, you can access a range of domestic and international shipping options to suit your delivery needs. Below is an overview of the available USPS services supported by Starshipit, including key features and delivery timeframes.

### Domestic services

**Ground Advantage**

* Used for domestic packages under 70lbs
* Fully tracked with delivery confirmation
* Cost-effective option for non-urgent shipments

**Priority Mail**

* Delivery in 1-3 business days
* Free boxes and envelopes available
* Includes tracking and insurance coverage up to $100

**Priority Mail Express**

* Fastest USPS service with overnight delivery to most locations
* Includes tracking, insurance and money-back guarantee

### International services

**Priority Mail International**

* Delivery in 6-10 business days to over 180 countries
* Tracking included for most destinations

**Priority Mail Express International**

* Delivery in 3-5 business days to many countries
* Includes tracking and insurance coverage up to $200

## Additional features

Using USPS via EasyPost integration with Starshipit allows users to select 'Signature Required' or 'Authority to Leave' on delivery.

## Configure USPS through EasyPost

| Setting | What it does |
| --- | --- |
| Enable USPS | Makes USPS available for shipment creation. |
| EasyPost API Key | Authenticates Starshipit with EasyPost. |
| EasyPost USPS Account ID | Identifies the USPS account in EasyPost. |
| Product codes | Add the USPS services enabled on the EasyPost account. |
| AES International Transaction Number (ITN) | Supplies the AES ITN for goods valued over US$2,500 when required for an international shipment. |

## Configure USPS through Direct API

If USPS has issued enterprise credentials directly rather than an EasyPost account, use the separate **USPS (via Direct API)** setup. Confirm with USPS which account numbers, IDs and mail classes your agreement authorises.

1. In UI 2.0, open **Settings > Couriers > [Add a new courier](https://next.starshipit.com/settings/couriers/add)** and select **USPS (via Direct API)**. For an existing connection, open [USPS (via Direct API) settings](https://next.starshipit.com/settings/couriers/setup/usps-direct-api).
2. Select **Enable USPS (via Direct API)** and enter the account details below.
3. Click **Save**, then add the specific product codes available on your account.
4. Reopen the connection and confirm the saved account details and product codes.

| Setting | What it does |
| --- | --- |
| Enable USPS (via Direct API) | Turns the direct USPS connection on. |
| Account number and Account type | Identify the USPS enterprise account. Contract rates require your own EPS payment account and account type `EPS`. |
| Use my USPS contract rates | Opts into your authorised agreement's contract quotes. Off by default; see the checks below before enabling it. |
| CRID | Identifies the USPS Customer Registration ID. |
| MID | Identifies the USPS Mailer ID. |
| Manifest MID | Identifies the MID used for manifesting. |
| Product codes | Select the USPS mail class codes available on your enterprise account. |
| Cancel shipment | Enter a tracking number on the Cancel shipment tab to submit a cancellation request. |

### Use your USPS contract rates

Before enabling this option, you need your own USPS agreement, an **EPS** payment account and authorisation for Starshipit to use it. Confirm the **Account number**, **CRID**, **MID** and **Manifest MID** with USPS. An EasyPost connection or credentials alone do not establish access to negotiated USPS rates.

This setup covers outbound US domestic shipments using your own EPS account. It does not cover returns, international contract rates, platform-funded agreements, or `PERMIT` and `METER` payment accounts.

1. Open **USPS (via Direct API)** settings in UI 2.0.
2. Enter the required account details and set **Account type** to `EPS`.
3. Select **Use my USPS contract rates**, then click **Save**.
4. Add the specific domestic mail classes covered by your agreement. `ALL` and `USPS_RETAIL_GROUND` are not supported for contract-rate quotes.
5. Reopen settings to check the option remains selected, then compare a representative domestic quote with your USPS agreement.

When enabled, Starshipit excludes published retail or commercial fallback prices. If USPS does not return an authorised contract rate, Starshipit reports an error rather than purchasing a label at a fallback price. Labels use the same EPS account as the contract rate holder.

Before switching shipping volume from EasyPost, arrange a controlled validation with USPS or Support and confirm both the quote and the settled charge for an intended shipment. A displayed quote does not prove the final charge or every commercial fee. Leave the option off for the existing retail-rate flow.

### Troubleshoot contract rates

| Problem | What to check |
| --- | --- |
| Settings will not save | Enter the EPS account number, `EPS` account type, CRID, MID and Manifest MID. |
| No contract rate is returned | Ask USPS to confirm the agreement, selected mail class and Starshipit authorisation. Do not assume an EasyPost agreement transfers automatically. |
| A label cannot be created | Check the selected mail class and contract-rate error. Both sender and destination must be in the US. Contact Support if the account details are correct. |