Royal Mail from ShipStation offers domestic and international shipping services for UK-based ShipStation V2 API accounts shipping from the UK.
This guide provides developers with the details needed to build Royal Mail from ShipStation shipping capabilities into your ShipStation V2 API workflows.
carrier_code: rm_cnd_walleted
- A ShipStation V2 API account based in the UK.
- ShipStation Carriers must be activated for the account and have a positive account balance to create labels. See our Using ShipStation Carriers page for details about activating it in your account.
- All shipments must originate from an address in the UK.
- All shipments must include both the weight and either the dimensions or the package type.
NOTE:
The Royal Mail from ShipStation integration is intended for those customers who ship less than 20 parcels per week, therefore parcels will be scanned individually upon collection.
Royal Mail from ShipStation supports rate shopping with ShipStation V2 API.
Available Royal Mail from ShipStation services are provided below. Please note that carriers may update their available services at any time. To ensure you are always using valid services, you can use the list carrier services endpoint at any time.
| Service | API Code |
|---|---|
| Domestic Tracked 24 - Drop off | rm_cnd_walleted_tracked24 |
| Domestic Tracked 24 - Parcel Collect (Bring My Label) | rm_cnd_walleted_tracked24_collect_bml |
| Domestic Tracked 24 - Parcel Collect (Print at Home) | rm_cnd_walleted_tracked24_collect |
| Domestic Tracked 24 with Signature - Drop off | rm_cnd_walleted_tracked24_sign |
| Domestic Tracked 24 with Signature - Parcel Collect (Bring My Label) | rm_cnd_walleted_tracked24_sign_collect_bml |
| Domestic Tracked 24 with Signature- Parcel Collect (Print at Home) | rm_cnd_walleted_tracked24_sign_collect |
| Domestic Tracked 48 - Drop off | rm_cnd_walleted_tracked48 |
| Domestic Tracked 48 - Parcel Collect (Bring My Label) | rm_cnd_walleted_tracked48_collect_bml |
| Domestic Tracked 48 - Parcel Collect (Print at Home) | rm_cnd_walleted_tracked48_collect |
| Domestic Tracked 48 with Signature - Drop off | rm_cnd_walleted_tracked48_sign |
| Domestic Tracked 48 with Signature - Parcel Collect (Bring My Label) | rm_cnd_walleted_tracked48_sign_collect_bml |
| Domestic Tracked 48 with Signature - Parcel Collect (Print at Home) | rm_cnd_walleted_tracked48_sign_collect |
| Express 10 - Drop off | rm_cnd_walleted_exp_10 |
| Express 10 - Parcel Collect (Print at Home) | rm_cnd_walleted_exp_10_collect |
| Express 10 - Parcel Collect (Bring My Label) | rm_cnd_walleted_exp_10_collect_bml |
| Express 24 - Drop off | rm_cnd_walleted_exp_24 |
| Express 24 - Parcel Collect (Print at Home) | rm_cnd_walleted_exp_24_collect |
| Express 24 - Parcel Collect (Bring My Label) | rm_cnd_walleted_exp_24_collect_bml |
| Express 48 - Drop off | rm_cnd_walleted_exp_48 |
| Express 48 - Parcel Collect (Print at Home) | rm_cnd_walleted_exp_48_collect |
| Express 48 - Parcel Collect (Bring My Label) | rm_cnd_walleted_exp_48_collect_bml |
| Express 48 Large - Parcel Collect (Print at Home) | rm_cnd_walleted_exp_lg_collect |
| Express 48 Large - Parcel Collect (Bring My Label) | rm_cnd_walleted_exp_lg_collect_bml |
| Express AM - Drop off | rm_cnd_walleted_exp_am |
| Express AM - Parcel Collect (Print at Home) | rm_cnd_walleted_exp_am_collect |
| Express AM - Parcel Collect (Bring My Label) | rm_cnd_walleted_exp_am_collect_bml |
| Service | API Code |
|---|---|
| International Tracked - Drop off | rm_cnd_walleted_tracked-s2h |
| International Tracked - Parcel Collect (Print at Home) | rm_cnd_walleted_tracked_collect |
| International Tracked - Parcel Collect (Bring My Label) | rm_cnd_walleted_tracked_collect_bml |
| International Tracked Heavier - Drop off | rm_cnd_walleted_tracked_heavier |
| International Tracked Heavier - Parcel Collect (Print at Home) | rm_cnd_walleted_tracked_heavier_collect |
| International Tracked Heavier - Parcel Collect (Bring My Label) | rm_cnd_walleted_tracked_heavier_collect_bml |
| International Tracked & Signed Heavier - Drop off | rm_cnd_walleted_tracked_sign_heavier |
| International Tracked & Signed Heavier - Parcel Collect (Print at Home) | rm_cnd_walleted_tracked_sign_heavier_collect |
| International Tracked & Signed Heavier - Parcel Collect (Bring My Label) | rm_cnd_walleted_tracked_sign_heavier_collect_bml |
| Global Priority EU - Drop off | rm_cnd_walleted_gp_eu |
| Global Priority EU - Parcel Collect (Print at Home) | rm_cnd_walleted_gp_eu_collect |
| Global Priority EU - Parcel Collect (Bring My Label) | rm_cnd_walleted_gp_eu_collect_bml |
| Global Priority ROW - Drop off | rm_cnd_walleted_gp_row |
| Global Priority ROW - Parcel Collect (Print at Home) | rm_cnd_walleted_gp_row_collect |
| Global Priority ROW - Parcel Collect (Bring My Label) | rm_cnd_walleted_gp_row_collect_bml |
| Name | Abbreviation | API Code | Package Attributes |
|---|---|---|---|
| Large Letter | LARGELETTER | rm_cnd_walleted_large_letter | International, Domestic |
| Medium Parcel | MEDIUMPARCEL | rm_cnd_walleted_medium_parcel | International, Domestic |
| Small Parcel | SMALLPARCEL | rm_cnd_walleted_small_parcel | International, Domestic |
Royal Mail from ShipStation does not support returns.
Adding shipment insurance is not supported for this carrier. Royal Mail does not provide any default loss/damage coverage.
- Label sizes: 4" x 6"
- Label formats: PDF, ZPL, PNG
Royal Mail from ShipStation does not support adding custom label messages.
Royal Mail from ShipStation does not currently support multi-package shipments.
Royal Mail from ShipStation supports voiding labels with ShipStation V2 API.
While Royal Mail via ShipStation supports electronic customs data, you must still print and attach a physical CN22 or CN23 form to the outside of your parcel. Providing electronic data does not remove the requirement for physical documentation. Failing to include it may result in your shipment being returned.
Automatic Customs Form Selection (CN22 vs. CN23): Please note that the API returns a CN23 for international shipments when the declared shipment value exceeds GBP 270. For shipments with a value up to and including GBP 270, a CN22 is returned.
NOTE: Action Required: New Zealand Border Levy Changes
Effective April 1, 2026, a new NZD $2.21 (+ GST) levy applies to low-value air freight consignments entering New Zealand. This levy is charged per consignment, not per item.
See the Shipping to New Zealand: Low Value Goods (LVG) Levy section in International Shipments for full details.
Royal Mail from ShipStation does not support advanced options.
Royal Mail from ShipStation shipments do not require manifesting.
When a shipment uses either of Royal Mail's Courier Collection services, a pickup request is automatically sent to Royal Mail when the label is created.
- Pickup Date will be set for the first available slot within the next 5 business days. Same-day collections are not available.
- Sunday Pickups are not supported. You will need to change the order date to the next day to create a label.
- Royal Mail shows an estimated time slot. They do not guarantee pickup times.
- If a label is voided, the pickup will be cancelled at the same time.
Royal Mail supports service points for Local Collect shipments. Local Collect allows recipients to collect parcels from a nearby Royal Mail Customer Service Point, Post Office, Collect+ store, parcel shop, or locker instead of receiving the parcel at a residential or business address.
Use the List Service Points endpoint (POST /v2/service_points/list) to find Royal Mail service points near a recipient's address. Provide the recipient's postal_code and country_code (GB) in your request, along with your Royal Mail carrier_id in the providers array.
Royal Mail returns the following location types:
| Royal Mail location type | Description |
|---|---|
| POL | Post Office |
| CSP | Customer Service Point |
| PSH | Parcel shop, including Collect+ locations |
| LOC | Locker |
To send a shipment to a Royal Mail service point:
- Find service points with the recipient's postcode and country code.
- Present the returned service points to the recipient to select their preferred location.
- Create a PUDO label using the selected
service_point_id. - Include the
LocalCollectservice enhancement in your label request. - Include either
NotificationsEmailorNotificationsPhoneso Royal Mail can notify the recipient when the parcel is ready for collection.
The following Royal Mail service codes support Local Collect:
ITC, ITD, ITE, ITF, ITL, ITM, ITN, ITS,
TPL, TPM, TPN, TPS, TRL, TRM, TRN, TRS- Get Service Point by ID is not supported. Royal Mail requires a country code and postcode for each service-point lookup. As a result, the integration supports listing service points but does not support retrieving a service point by ID alone.
- Importing service points is not supported. Royal Mail requires country and postcode values to search for locations, so service points cannot be imported into the ShipStation API service-point database in advance.
- Special Delivery Guaranteed restrictions apply. Local Collect is not available for Special Delivery Guaranteed items sent to a Collect+ branded Royal Mail parcel shop or an RM locker.
- The
LocalCollect,Email, andSMSservice enhancements are relevant when creating a PUDO shipment. When a PUDO location is specified, provide an email address or phone number throughNotificationsEmailorNotificationsPhone. - Royal Mail services and service-point availability may change. Use the carrier services and service-point endpoints to retrieve current availability.
Royal Mail from ShipStation supports receiving tracking updates. Review our Track a Package guides for details on tracking with the ShipStation V2 API.