---
title: "Create a Single AWB"
method: POST
path: "/dpi/shipping/v1/awbs"
tags: ["AWBs"]
deprecated: true
---

# Create a Single AWB

`POST /dpi/shipping/v1/awbs`

## Request

- Base URL: `https://api-sandbox.dhl.com`
- URL: `https://api-sandbox.dhl.com/dpi/shipping/v1/awbs`
- Auth: none declared. Required headers: `Authorization`

> **Deprecated.**

Creates a new single awb based on the given data. This request will be decommissioned. Please use /dpi/v1/bulk/{customerEkp}/mixedorders instead.

## Headers

- `Authorization` string, required

## Request body

- Awb
  - `awbCopyCount` integer, required: Copies of AWB labels. One AWB per final receptacle required. Number between 1 and 99.
  - `contactName` string, required: Contact name for paperwork.
  - `customerEkp` string, required: Deutsche Post Customer Account number (EKP) of the customer who wants to create an single awb.
  - `itemFormat` 'P' | 'G' | 'E' | 'MIXED', required: The item format for this awb.
  - `jobReference` string: Job reference for the whole shipment.
  - `product` 'GMM' | 'GMR' | 'GMP' | 'GPT', required: The product that is used for the shipment of this item. Available products are: GMP [Packet Priority/Prio (goods)], GPT [Packet Tracked/Tracked], GMM [Business Mail Priority/Prio (documents)], GMR [Business Mail Registered/Plus (documents)]
  - `serviceLevel` 'PRIORITY' | 'REGISTERED', required: The service level that is used for the shipment of this item. There are restrictions for use of service level: Registered is only available with product GMR and SalesChannel DPI
  - `telephoneNumber` string: Telephone number for paperwork. Mandatory for sales channel EXPRESS.
  - `totalWeight` number, double: Total weight of the awb (in kg).

## Response `200`

Bytestream (File) containing the awb label.

- Awb
  - `awbCopyCount` integer, required: Copies of AWB labels. One AWB per final receptacle required. Number between 1 and 99.
  - `contactName` string, required: Contact name for paperwork.
  - `customerEkp` string, required: Deutsche Post Customer Account number (EKP) of the customer who wants to create an single awb.
  - `itemFormat` 'P' | 'G' | 'E' | 'MIXED', required: The item format for this awb.
  - `jobReference` string: Job reference for the whole shipment.
  - `product` 'GMM' | 'GMR' | 'GMP' | 'GPT', required: The product that is used for the shipment of this item. Available products are: GMP [Packet Priority/Prio (goods)], GPT [Packet Tracked/Tracked], GMM [Business Mail Priority/Prio (documents)], GMR [Business Mail Registered/Plus (documents)]
  - `serviceLevel` 'PRIORITY' | 'REGISTERED', required: The service level that is used for the shipment of this item. There are restrictions for use of service level: Registered is only available with product GMR and SalesChannel DPI
  - `telephoneNumber` string: Telephone number for paperwork. Mandatory for sales channel EXPRESS.
  - `totalWeight` number, double: Total weight of the awb (in kg).

## Other responses

- `403`: User 'xxx' has no permission.
- `404`: There is no customer matching the given EKP.
- `422`: Data error, please check response message for details.
- `500`: Internal error.

---

[API](https://skmtc.dev/dhl/apis/deutsche-post-international-shipping-api.md) - [All operations](https://skmtc.dev/dhl/apis/deutsche-post-international-shipping-api/llms.txt) - [OpenAPI document](https://skmtc.dev/dhl/apis/deutsche-post-international-shipping-api/revisions/33ba987e477f?raw)