---
title: "Update Account"
method: PUT
path: "/v4/shippingAccounts/dhlexpress/{shippingAccountId}"
tags: ["Shipping Accounts"]
---

# Update Account

`PUT /v4/shippingAccounts/dhlexpress/{shippingAccountId}`

## Request

- Base URL: `https://api.intersoftsapient.net`
- URL: `https://api.intersoftsapient.net/v4/shippingAccounts/dhlexpress/{shippingAccountId}`
- Auth: OAuth 2
  - Client credentials
  - Token URL: `https://authentication.intersoftsapient.net/connect/token`

Update shipping account details.
<br />
<br />***Note:** All required fields must be populated in the request, regardless if they need updating or not.*

## Path parameters

- `shippingAccountId` string, required

## Request body

- DhlExpressUpdateShippingAccountRequest: DHL Express Update Shipping Account Request
  - `AccountNumber` string, required: Carrier Account Number / The account number given by the carrier.
  - `AccountType` 'Sandbox' | 'Production', 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.
  - `AccountName` string, required: The official name of the shipping account as designated by the user or organisation, aiding in easy identification and reference of accounts. <br /> <br />***Note:** By default, this value is set to the customer name if not provided in the request.*
  - `AccountAlias` string, required: 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: The name of the primary contact person for the shipping account, facilitating communication regarding shipping and account-related matters.
  - `ContactNumber` string, tel, required: The phone number associated with the shipping account's primary contact person, facilitating communication regarding shipping inquiries, account management, and issue resolution.
  - `ApiKey` string, required: A unique API Key assigned to a specific DHL Express account. It is essential for authenticating and authorising API requests.
  - `ApiSecret` string, required: A unique API Secret assigned to a specific DHL Express account. It is essential for authenticating and authorising API requests.
  - `IsArchiveLabels` boolean: Indicates whether DHL waybill documents are available for download as PDF. <br /> <br />Valid values are the following: <br /><ul><li>**True** - the way bill documents will be available for download in PDF format</li><li>**False** - the way bill documents will not be available for download</li></ul>
  - `IsPaperlessTradeEnabled` boolean: Indicates whether the documents are submitted electronically. <br /> <br />Valid values are the following: <br /><ul><li>**True** - the documents can be submitted electronically</li><li>**False** - the documents cannot be submitted electronically</li></ul>
  - `PaperlessTradeInvoiceOption` 'DhlGenerated' | 'SapientGenerated': Specifies the DHL Paperless Trade (PLT) invoice option for electronically transmitting commercial invoice documentation. <br /> <br />Valid values are the following: <br /><ul><li>**DhlGenerated**: This value allows DHL to create the invoice and send it electronically to the customs agency.</li><li>**SapientGenerated**: This value generates the invoice from the shipment data in SAPIENT and sends it to DHL.</li></ul><i>**Note**: This field is only applicable if the **IsPaperlessTradeEnabled** field is set to true.</i>

## Response `200`

The shipping account was updated successfully.

## Other responses

- `400`: Invalid request response.
- `401`: Unauthorized
- `403`: Forbidden
- `404`: The shipping account was not found.
- `500`: Internal Server Error

---

[API](https://skmtc.dev/intersoftsapient/apis/dhl-express.md) - [All operations](https://skmtc.dev/intersoftsapient/apis/dhl-express/llms.txt) - [OpenAPI document](https://skmtc.dev/intersoftsapient/apis/dhl-express/revisions/4259ed907a39?raw)