v1

latestOpenAPI 3.0.12026-07-242073551.1 MB

Shipping Accounts

Update Associated Location

Update the details of an existing shipping location associated with a specific Royal Mail shipping account with carrier specific details, such as posting location, OBA access code, and receiving hub code.

put/v4/shippingAccounts/rm/{shippingAccountId}/shippingLocations/{shippingLocationId}

Path parameters

shippingAccountIdstring required

A unique identifier for the shipping account assigned by the system (ShippingAccountId) or by you (AccountAlias), allowing for efficient reference and management of individual accounts within the system.

shippingLocationIdstring required

A unique identifier for the shipping location assigned by the system or by you (alias), allowing users to reference and manage specific locations effectively.

Request body

PostingLocationCodestring required

A unique number assigned to this location by Royal Mail. This code is essential for identifying the particular location from which shipments are dispatched. It facilitates the processing and tracking of mail and packages by providing a clear reference to the origin of the shipment within the Royal Mail network.

ObaAccessCodestring nullable

The OBA Access Code (Online Business Account Access Code) is a password associated with the Royal Mail shipping account that grants access to the Online Business Account (OBA) services. This code is crucial for ensuring that the account is secure and allows for the management of shipping tasks online. <br /> <br />Note: A Royal Mail shipping account cannot be activated or used for shipping unless the OBA Access Code has been provided.

ReceivingHubCodestring required

A code that refers to the Receiving Hub or Regional Distribution Center (RDC) used for this shipping location. This code must correspond to an existing Receiving Hub recognised by Royal Mail. <br /> <br />Note: If the Receiving Hub code is not provided during the account creation process, Royal Mail will automatically match it to the Receiving Hub that corresponds to the postcode of the location's address. For more information, refer to the Royal Mail Receiving Hubs for a list of possible locations.

Example request

{
  "PostingLocationCode": "2345654321",
  "ObaAccessCode": "123456",
  "ReceivingHubCode": "002610"
}

Response

Updates the shipping location