Update Account

put

https://api.intersoftsapient.net/v4/shippingAccounts/rm/{shippingAccountId}

Update the details of an existing shipping account. With this endpoint, you can modify various attributes of the shipping account, such as contact information, service options, and others. This helps maintain current and accurate information for effective shipping operations.

Path Params

shippingAccountId

string

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.

Body Params

Shipping Account Details

Royal Mail Update Shipping Account Request

AccountRegisteredEmail

string

required

length between 1 and 256

The email address that was used to register the shipping account with Royal Mail when the account was created. This email serves as the primary contact point for communications related to the shipping account, including notifications, updates, and service alerts from Royal Mail.

RegisteredBillingPostcode

string | null

The postcode associated with the billing address for the shipping account. This postcode is used by Royal Mail for sending invoices and other relevant billing communications related to the account.

Note: This field is mandatory only if the AccountType field is set to Production.

AccountNumber

string

required

length between 10 and 10

The number assigned to the shipping account by the carrier, typically used for tracking shipments and billing purposes.

AccountType

string

enum

required

Indicates whether the account is set up as a "sandbox" or "production" account. A Sandbox account is for testing and development, while a Production account is used for live shipments and transactions.

Allowed:

AccountName

string

required

length between 1 and 35

The official name of the shipping account as designated by the user or organisation, aiding in easy identification and reference of accounts.

Note: By default, this value is set to the customer name if not provided in the request.

AccountAlias

string

required

length between 1 and 30

A unique, user-defined name for the shipping account, providing a convenient way to reference the account in a more memorable manner.

ContactName

string

required

length between 1 and 100

The name of the primary contact person for the shipping account, facilitating communication regarding shipping and account-related matters.

ContactNumber

string

required

length between 1 and 20

The phone number associated with the shipping account's primary contact person, facilitating communication regarding shipping inquiries, account management, and issue resolution.

Responses

200

The shipping account was updated successfully.

401

Unauthorized

403

Forbidden

404

The shipping account was not found.

500

Internal Server Error

400Invalid request response.