Royal Mail Click & Drop
Royal Mail Click and Drop is a free tool allowing merchants to buy and print postage labels online. Within your Click and Drop account, specify the package weight and the postage service you require, make your payment and print your label. Once you've attached the label to your package, you can drop it off at your local post office.
ShopWired's Click & Drop app offers a direct integration with this Royal Mail service, enabling you to automatically or manually export orders to your Click & Drop account.
To install the Click & Drop app:
- Navigate to Apps
- Locate the Royal Mail Click & Drop app
- Select
install this app
Requirements for using Click & Drop
Requirements for using Click & Drop
To use the Click & Drop app:
- You'll need to have a Click & Drop account. You can create one here
- You'll need to
- You'll need to configure the Click & Drop app
Adding your API keys from Click & Drop
Adding your API keys from Click & Drop
To add your Click & Drop API key to ShopWired's Click & Drop app:
- Log in to Click & Drop
- Select dashboard from the menu and then integrate your online stores
- Select add a new integration
- Select the Click & Drop API button:
- Select your settings, and then select save and connect
- Once the integration has been created, click on its name in the integrations list
- Select the clipboard icon next to the API key to copy the key to your computer's clipboard
- Select update and connect
- In ShopWired navigate to Apps > Installed > Manage > Click & Drop
- Paste the API key into the Royal Mail Click & Drop API Key setting
- Select save changes
Royal Mail Click & Drop OBA/business accounts
Royal Mail Click & Drop OBA/business accounts
If you have a Royal Mail OBA/business account, you can select the I have an OBA account setting.

Selecting the OBA option will enable you to select the Parcel option in the Package Size drop-down, allowing you to select this option for your delivery rates.
This setting also changes the validation process that the app performs (ensuring service code and package size combinations are valid). You should therefore always check with your Royal Mail account to ensure you are selecting valid combinations as these will cause Royal Mail's API to reject the order.
Applying postage to Click & Drop shipments
Applying postage to Click & Drop shipments
Orders are sent to Royal Mail's Click & Drop service with the postage service automatically applied. You can deselect the Send orders with post applied setting to apply postage manually.

Settings
Settings
How orders should be exported
Orders can be exported in one of two ways, either automatically or manually (through the app). In both cases, the app listens for changes to an order's status.
To export orders automatically to Click & Drop, select the Send orders automatically setting and select the order status an order should have for it to be exported.

To send orders manually to Click & Drop, select the Send orders manually setting and select the order status an order should have for it to appear in the Manual export section of the app.

Select what status an order should be changed to after being exported to Click & Drop
When an order has been successfully exported to Click & Drop, the app can automatically change the status of the order. You can select what status you'd like orders to be given, e.g. dispatched
, from the setting.
Send an email to the customer once the order is exported to Click & Drop
To automatically send an order status email to customers once an order has been exported to Click & Drop (for example a Preparing to dispatch email) select this setting.
Include your (company) details on the order sent to Click & Drop
Select this setting to send company details (taken from your ShopWired account) to Click & Drop when an order is exported.
Who should receive email updates from Royal Mail about the order?
Updates about shipments are sent by Royal Mail when one of the following services is used:
- Tracked 24
- Tracked 24 with signature
- Tracked 48
- Tracked 48 with signature
Select this setting to determine whether you or your customer will receive these email updates from Royal Mail.
Dispatch information
Dispatch information
Once a postage label has been purchased on the Click & Drop website, the Click & Drop app can:
- Automatically change the status of the corresponding order within your ShopWired account
- Add in the tracking information from Royal Mail into the
tracking URL
setting for the order - Tracking URLs are only available for Signed For, Special Delivery and other similar services
- Send an order status email to the customer
The Click & Drop app checks for dispatch information every hour for a maximum of 2 weeks following an order's export to Click & Drop.
Mapping delivery rates to Royal Mail services
Mapping delivery rates to Royal Mail services
You can map each delivery rate in your ShopWired account to a corresponding Royal Mail service and package size in the delivery rates mapping section. For orders using a different service, e.g. DHL, you do not need to map the delivery rates.
For each delivery rate, select the Service and Package Size from the available setting.

Automatic export
Automatic export
To export orders automatically to Click & Drop, to the corresponding status selected for automatic export.
Once exported, orders take up to 2 minutes to export to Click & Drop and once exported will appear in your Click & Drop account where you can approve postage, pay for and then print the shipping label. Successfully exported orders appear in the Exported orders section.
If an order fails to export automatically it will appear in the Export errors section.
Manual export
Manual export
To export orders manually to Click & Drop, to the corresponding status selected for manual export.
Orders take up to 2 minutes to appear in the Manual export section once the order status has changed.
To export an order manually to Click & Drop:
- Select
apply postage
- Create at least one package for the order (an order can be split across multiple packages if needed)
- Use the Total weight setting to configure the weight of the package
- Use the Package size setting to configure the size of the package you are sending (the list of available packages will be modified depending on the total weight)
- Use the Service setting to select the service for the package
- When shipping an order outside of the UK, you must select each product included in the package (Royal Mail uses this information for
Custom service codes
Custom service codes
The app includes the 12 default service codes for delivery in the UK and 4 default service codes for international delivery.
To use alternative service codes (e.g. those provided through the OBA service):
- Navigate to the Custom service codes section
- Enter a Description for the service code (this is used for internal purposes only)
- Enter the Service code provided by Royal Mail
Once created, custom service codes will be available for you to map to your delivery rates.
Click & Drop export errors
Click & Drop export errors
If an order fails to export to Click & Drop, it will be displayed in the Export errors section.
Orders can fail to export for a number of different reasons, for example, the shipping rate selected on the order was not mapped to a corresponding Royal Mail service.
When an order fails to export, you can fix the error (either with the order or with the app settings) and select retry export
to try and export the order again. Alternatively, select move to manual export
to export the order manually.
Common export errors, reasons and solutions
Error | Reason | Solution(s) |
---|---|---|
An error occurred due to missing information |
The app failed to find a valid value for one or more of the following: number of packages, who to notify for tracking, Royal Mail service, recipient address, sub-total, total, the shipping charge, or the order reference number. | - Check the order to ensure the sub-total and total are present and positive numbers. - Check the order has a valid shipping address. - Check the delivery rate mapping in the app to ensure the delivery rate being used in the order has a valid Royal Mail service selected. |
The service was missing or invalid |
The app failed to find a valid Royal Mail service for the delivery rate being used by the order. | - Check the delivery rate mapping in the app to ensure a valid service has been selected for the delivery rate being used in the order. |
A package had an invalid combination of either service, package size, weight, or country |
The app could not find a valid Royal Mail service, a valid package format, valid package weight, or valid delivery country in the order. | - Check that the order products contain the correct weights. - Check that the shipping address has a valid country. - Check the delivery rate mapping in the app to ensure a service and package format have been selected for the delivery rate in use. |
A package had a missing or invalid weight or package size |
The app could not find a valid package weight or package format. | - Check that the products within the order have the correct weights and check the delivery rate mapping in the app to ensure a package format has been selected for the delivery rate in use. |
The order had no recognisable packages |
The app couldn’t find any valid products to put into the Royal Mail order. | - Check that all products in the order have a valid price and weight. |
No API key found |
The app has received a valid order but cannot find an API key. This error means that the user either has not provided an API key in the app settings or they have provided an invalid API key. | - Check there is a valid API key within the Royal Mail Click & Drop API Key setting inside of the App Configuration section. |
Royal Mail's API rejected the order... |
The app attempted to send the order to Royal Mail, but they have rejected the order. The app has not received a reason for the rejection from Royal Mail’s API. | - Review the order looking for incorrect combinations of product weights, package formats, and service codes. If no reason can be identified for the error, contact support. |
An error occurred while connecting to Royal Mail |
The app failed to generate a valid connection to the Royal Mail API. This is either caused by an outage with the app or an outage with Royal Mail’s API. | - Please report this error to support. |
Royal Mail Error Message: ... |
These error messages are generated directly by Royal Mail. These can be caused by various things, but the error message should explain what the issue is. | - The error message generated by Royal Mail should inform the user what went wrong with the order. If no solution is obvious, contact the developer. |
Royal Mail Error Message: Property ‘PhoneNumber’ max length is 25, provided length is ... |
This error message is caused by the phone number for either the recipient address, billing address, or sender address being longer than 25 characters. | - Check the phone number length on the shipping and billing address for the order. - Check the company phone number length for the business in Website > Company information |
International shipping (product requirements)
International shipping (product requirements)
When shipping orders internationally, Royal Mail requires certain information about each product in the shipment to formulate a :
- An
- A
- An
This information can be added for products either when creating or editing the product or when using the product import/export system.