Add a USPS account
This guide walks through setting up a USPS account in the Carriyo Dashboard. It covers the required roles, the credentials to collect, and every field USPS expects.
At a glance
Before you start
- A USPS account in good standing, plus its API credentials. The required fields are listed in All USPS settings below.
- Decide the account country and the default service and label format this account uses.
Open the carrier accounts page
In the Carriyo Dashboard, open Settings in the left sidebar. Under Carrier Management, choose Carrier Accounts, then click the + add icon to start a new account.
Open settings
Go to Carrier Accounts
Add a new carrier account
Pick USPS
In the carrier picker, search for USPS and click Select. Carriyo creates a USPS account and opens the credential step.
Search for the carrier
Enter the basics
The first wizard page collects two fields:
- Account name
- A label that's meaningful to your team (e.g.
USPS your country). Keep it short and unique. - Account country
- The country this account ships from. Determines the routes and services available.
Fill in the account name and country.
- 1Account Name
- 2Account Country
Enter your USPS account details
Enter the required USPS account details, then click Next. Every field is documented in All USPS settings below, with examples and accepted values.
Fill in the USPS account details.
- 1Mail Class
- 2Processing Category
Fill in the USPS account details.
- 1Package Type
- 2Package Location
Configure the account
The new account opens on its detail page. General settings work the same way for every carrier: the Active toggle, default label and service, and currency. See Add a carrier account for the full reference to these shared settings — default label, merchant access, going live, and common mistakes.
Go to the account page
View the account details
Set the default label format
Merchant access
On multi-merchant tenants, restrict the account to specific merchants via the Permissions tab, then Save.
Add merchants to this carrier account
All USPS settings
Every field USPS exposes in the carrier account, grouped by section. Carriyo stores secrets encrypted and never shows them after saving.
Account Details
6 fieldsAccount-level configuration and defaults applied to shipments.
| Field | Type | What to enter |
|---|---|---|
| Use Carriyo RateOptional | Toggle | Enable to bill postage at Carriyo's negotiated USPS rates instead of your own account's contract rates. |
| Account TypeOptional | Select | Select how this USPS account is funded. Defaults to EPS (Enterprise Payment System) if left blank. Example: EPS (Default) EPSPERMITMETER |
| Customer Registration ID (CRID)Optional | Text | Your USPS Customer Registration ID, from the Business Customer Gateway. Required for live accounts. Example: e.g., 123456789 |
| Master MIDOptional | Text | Your USPS Mailer ID used as the label owner, from the Business Customer Gateway. Required for live accounts. Example: e.g., 123456789 |
| Master Manifest MIDOptional | Text | Mailer ID used on shipment manifests. Often the same as your Master MID. Issued by USPS. Required for live accounts. Example: e.g., 123456789 |
| Account Number (Merchant EPA)Optional | Text | Your USPS Enterprise Payment Account number that postage is charged to. Required for live accounts. Example: e.g., 123456789 |
Service Options
6 fieldsDefault service and product options applied to shipments.
| Field | Type | What to enter |
|---|---|---|
| Mail ClassRequired | Select | Select the USPS mail class (service level) to book shipments with on this account. Example: Priority Mail - Reliable 1–3 day shipping with tracking Parcel Select - Ground delivery, converts to USPS Ground Advantage if no entry facilityUSPS Connect Local - Same/next-day local delivery within limited areasUSPS Connect Regional - Fast regional ground delivery for nearby zonesUSPS Connect Mail - Bulk mail entry service (requires FLATS processing)USPS Ground Advantage - Default ground service, 2–5 day deliveryPriority Mail Express - Fastest USPS service with overnight delivery |
| Processing CategoryRequired | Select | Select the USPS processing category describing how your mail piece is sorted and handled. Example: Letters - Valid only for Priority Mail or Priority Mail Express (outbound and return) Letters - Valid only for Priority Mail or Priority Mail Express (outbound and return)Flats - Required for USPS Connect MailMachinable - Standard automation-compatible packagingNonstandard - Nonstandard or irregular-shaped shipments |
| Extra ServicesOptional | Multi | Select any add-on USPS services (e.g. signature, insurance, hazardous materials) to apply by default to shipments on this account. Global Direct Entry (365)USPS Label Delivery Service (415)Tracking Plus 6 Months (480)Tracking Plus 1 Year (481)Tracking Plus 3 Years (482)Tracking Plus 5 Years (483) |
| Rate IndicatorOptional | Select | Select the USPS rate indicator describing the packaging/pricing tier used for rating. Defaults to Single Piece (SP). Example: Single Piece (SP) (Default) 3-Digit (3D)3-Digit Dimensional Rectangular (3N)3-Digit Dimensional Nonrectangular (3R)5-Digit (5D)Basic (BA)Mixed NDC (BB) |
| Destination Entry Facility TypeOptional | Select | Select the type of USPS facility where you drop off mail for entry. Choose None unless you pre-haul to a USPS facility for discounted rates. Example: None (Default) NoneDestination Network Distribution CenterDestination Sectional Center FacilityDestination Delivery UnitDestination Service Hub |
| Price TypeOptional | Select | Select the USPS pricing tier to rate shipments at. Defaults to Commercial. Example: Commercial (Default) RetailCommercialContract |
Customs Form
2 fieldsConfigure your USPS account customs form settings.
| Field | Type | What to enter |
|---|---|---|
| Customs Content TypeOptional | Select | Select what the parcel contains for the customs declaration on international shipments. Example: Commercial (Default) MerchandiseGiftDocumentCommercial SampleReturned GoodsHumanitarian Donations |
| Customs Content Comments (required when Customs Content Type is Other)Optional | Text | Describe the contents in your own words. Required when Customs Content Type is set to Other. Example: ex. Some other content |
Shipper Details
12 fieldsFill this if you wish to include additional Shipper details in the USPS shipment.
| Field | Type | What to enter |
|---|---|---|
| Contact First NameRequired | Text | — |
| Contact Last NameRequired | Text | — |
| Contact PhoneRequired | Text | — |
| Contact EmailOptional | Text | — |
| Company NameOptional | Text | — |
| Address 1Required | Text | — |
| Address 2Optional | Text | — |
| CountryRequired | Text | Choose one of: AfghanistanAlbaniaAlgeriaAmerican SamoaAndorraAngola |
| StateRequired | Text | — |
| CityRequired | Text | — |
| AreaOptional | Text | — |
| Post codeRequired | Text | — |
Return Details
12 fieldsFill this if you wish to include Return address details for USPS shipments.
| Field | Type | What to enter |
|---|---|---|
| Contact First NameRequired | Text | — |
| Contact Last NameRequired | Text | — |
| Contact PhoneRequired | Text | — |
| Contact EmailOptional | Text | — |
| Company NameOptional | Text | — |
| Address 1Required | Text | — |
| Address 2Optional | Text | — |
| CountryRequired | Text | Choose one of: AfghanistanAlbaniaAlgeriaAmerican SamoaAndorraAngola |
| StateRequired | Text | — |
| CityRequired | Text | — |
| AreaOptional | Text | — |
| Post codeRequired | Text | — |
Pickup Details
3 fieldsConfigure pickup location and preferences for USPS shipments.
| Field | Type | What to enter |
|---|---|---|
| Package TypeRequired | Select | Select the service the packages awaiting carrier pickup belong to, so USPS schedules the correct collection. Example: Priority Mail First-Class Package ServicePriority Mail ExpressPriority MailReturnsUSPS Ground AdvantageInternational |
| Package LocationRequired | Select | Tell the USPS carrier where to collect the packages from at the pickup address. Example: Front Door Front DoorBack DoorSide DoorKnock on DoorMail RoomOffice |
| Special InstructionsOptional | Text | Add free-text notes telling the carrier exactly where to find the packages. Required when Package Location is Other. Example: Enter special pickup instructions |
Label
3 fieldsConfigure how your USPS shipping labels will be generated and formatted for printing.
| Field | Type | What to enter |
|---|---|---|
| Image TypeOptional | Select | Choose the label file format. Use PDF for standard printers or ZPL for thermal label printers. Defaults to PDF. Example: PDF (Default) PDFZPL 203 DPIZPL 300 DPI |
| Label TypeOptional | Select | Choose the label size to match your label stock. Defaults to 4x6. Example: 4x6 Label (Default) 4x4 Label4x5 Label4x6 Label2x7 Label |
| Receipt OptionOptional | Select | Choose whether to print a receipt alongside the label and how to lay it out. Defaults to None. Example: None (Default) NoneSame PageSeperate Page |
Reference Mappings
1 fieldMap Carriyo fields to the reference values the carrier expects.
| Field | Type | What to enter |
|---|---|---|
| Customer Reference NumberOptional | Select | Choose which Carriyo reference is sent to USPS as the customer reference. Defaults to Shipment Reference. Example: Shipment Reference (Default) Order ReferenceShipment Reference |
Capability notes
Behavior that follows from USPS's capabilities. Read these before you go live.
shipped, in_transit, delivered…) reach Carriyo automatically. No polling, and nothing to set up on your side.