Royal Mail shipping account setup

This page will detail a step by step guide on how to add a shipping account.



Before you can set up a shipping account, you must ensure you have enabled the label integration with Royal Mail.


There are two ways of adding a tracking account on the system:

  1. From the Integration Activation screen select Royal Mail - Configure Label - Manage Shipping Account - Add Shipping Account.
  2. Using the Shipping Account tab via the main menu page.

To begin, click the "Add Shipping Account" button from the Shipping Accounts tab of the Main Menu page.

Account Details:

  1. Using the Carrier Selection drop down, select Royal Mail. This will only be relevant if you have integrated with multiple carriers as a full list will show via this drop down.
  2. Using the drop down, select the Shipping Location you wish to assign this account to.

Shipping Account:

  1. Enter your Carrier Account Number - This must be a ten digit number. If your account number is shorter than this, you will need to add the required amount of zero's at the beginning of the number to ensure it is ten digits long.
  2. Click the drop down under the Account Type . This is where you would select whether you would like to create this account in Sandbox or in Production.
  3. Enter the Account Name.
  4. Enter the Registered Email Address - This is the email that was used to register the Royal Mail Online Business Account. More information on this can be found here.
  5. Enter the Registered Billing Postcode - This is your company address postcode registered with Royal Mail for receiving invoices.
  6. Enter a memorable name and populate this in the Alias section - The Alias is a name which can be used in the API request instead of using the Shipping Location ID when connecting to us. Therefore, it is recommend that this name be memorable and something you have at hand to refer to in the future.
  7. Enter a Contact Name and Contact Number for the account.

Carrier Details:

  1. Add a Posting Location Code (PLN) - This is a Royal Mail specific code given for each location you are despatching shipments from. This will be a 10 digit number and will always start with 9000. For example 9000257150.
  2. Receiving Hub Code: This is a code allocated by Royal Mail for the receiving Hub your goods will be taken to. The Receiving Hub code will be automatically populated based on the postcode of the shipping location you are linking this account to.
  3. OBA Access Code - This will be auto populated on our end and is something we communicate directly with the carrier after the shipping account has been added.

Once all the required information has been populated, click Add Shipping Account . You have now successfully added a shipping account.

Account Approval:


NOTE: You will not be able to ship with Royal Mail until your account has been approved.

  1. If the account type you have created is production, you will receive a confirmation email.
  2. The account status will show as 'Disabled' until the account has been approved by the Royal Mail OBA team. This can typically take 2-5 working days.
  3. Once the account has been approved, the status will change to 'Enabled'. You can check the account status by viewing the shipping account or via the 'Get Account' API.
  4. If the account cannot be approved, we will contact you and advise accordingly.


Shipping Account(s) can be added and managed via API. Find out more in the API Reference