> ## Documentation Index
> Fetch the complete documentation index at: https://help.nextmatter.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Integrate with DHL

> Create shipments and return corresponding shipment tracking numbers, labels, and documentation.

1. Select the Next Matter workflow that should integrate with DHL.

2. Click **Edit workflow**.

3. Click **Add step** and select **Integrations** as the step type.

4. Click the step to open it.

5. Click **Settings**.

6. Select POST as the Method and enter the following URL:

   <CodeGroup>
     ```http HTTPS theme={null}
     URL: https://api-eu.dhl.com/parcel/de/shipping/v2/orders
     ```
   </CodeGroup>

7. Create the following **Headers**

   * **Accept**: application/json

   * **dhl-api-key**: `YOUR_DHL_API_KEY` You can create the key by clicking [this link](https://developer.dhl.com/api-reference/parcel-de-shipping-post-parcel-germany-v2#get-started-section/user-guide) and clicking the **Get Access** button in the top right corner.

   * **Content-type**: application/json

   * **Authorization**: `Basic authentication` (replace with your data)

   * **Accept-Language**: DE-de

8. Enter the **Body** of the request. It might look like the following (make sure to replace the placeholders)

   <CodeGroup>
     ```json JSON theme={null}
     {
       "profile": "STANDARD_GRUPPENPROFIL",
       "shipments": [
         {
           "product": "REPLACE_PRODUCT",
           "billingNumber": "BILLING_NUMBER",
           "refNo": "ORDER_NUMBER",
           "shipper": {
             "name1": "REPLACE_SHIPPER_COMPANY_NAME",
             "addressStreet": "REPLACE_SHIPPER_STREET",
             "additionalAddressInformation1": "REPLACE_SHIPPER_STREET,
             "postalCode": "REPLACE_SHIPPER_POSTALCODE",
             "city": "REPLACE_SHIPPER_CITY",
             "country": "DEU",
             "email": "REPLACE_SHIPPER_EMAIL",
             "phone": "REPLACE_SHIPPER_PHONE"
           },
           "consignee": {
             "name1": "REPLACE_CONSIGNEE_NAME",
             "addressStreet": "REPLACE_CONSIGNEE_STREET",
             "additionalAddressInformation1": "REPLACE_CONSIGNEE_STREET",
             "postalCode": "REPLACE_CONSIGNEE_POSTALCODE",
             "city": "REPLACE_CONSIGNEE_CITY",
             "country": "DEU",
             "email": "REPLACE_CONSIGNEE_EMAIL",
             "phone": "REPLACE_CONSIGNEE_PHONE"
           },
           "details": {
             "dim": {
               "uom": "mm",
               "height": REPLACE_DIM_HEIGHT,
               "length": REPLACE_DIM_LENGTH,
               "width": REPLACE_DIM_WIDTH
             },
             "weight": {
               "uom": "g",
               "value": REPLACE_DIM_WEIGHT_IN_GRAMS
             }
           }
         }
       ]
     }
     ```
   </CodeGroup>

9. Click **Save changes**.

If needed, refer to the [DHL API docs](https://developer.dhl.com/api-reference/parcel-de-shipping-post-parcel-germany-v2?language_content_entity=en#operations-tag-Shipments_and_Labels).
