➕ Create, Download, Delete Shipping Label

The Seven Senders Label API provides a unified interface to generate shipping labels for more than 50 carriers. Labels are generated via a simple three-step workflow:

Authenticate with your API key to obtain an access token
Create a label via POST /v2/labels
Download the label via GET /label-download/{id}

Beyond standard label generation, the service also offers powerful features such as intelligent shipping rules and customizable label content extensions, which are described in separate sections. This page focuses on the core workflow for creating and retrieving labels.

Label API Workflow for Label Creation

Step 1: Authentification

In the first step, you authenticate using the provided API key to request an access token. A detailed explanation is available in the Authentication section.

https://api-uat.sevensenders.com/v2/token

https://api.sevensenders.com/v2/token

Authentication

Authentication is handled via an API key that is assigned to you for the duration of the project. Upon sending the request, the system returns an access token, which remains valid for 60 minutes.

{
  "access_key": "your_apikey"
}

{
  "token": "your_token"
}

Use the returned token in the Authorization header of subsequent requests likePOST Labelsor GET Labels

Authorization: Bearer your_token

Step 2: Create a Carrier Label (POST /v2/labels)

A full list of all available parameters — including allowed values and whether they are mandatory or optional — can be found in the parameter reference. Additional case-specific examples (PUDO, Return in the Box, Dangerous Goods shipments, etc.) are provided in separate sections.

https://api-uat.sevensenders.com/v2/labels

https://api.sevensenders.com/v2/labels

Generate Carrier Label via POST Labels Request

In the following request, a carrier label is created. It includes the fundamental parameters required to generate a carrier label. The POST Label response includes core information about the created label, such as the tracking_code and the label_url for downloading it

{
  // Sender Address Data
  "warehouse": "Main Warehouse Vienna",
  "warehouse_address": "Lagerstraße 5, 1200 Wien, AT",

  // Recipient Address Data
  "recipient_first_name": "Anna",
  "recipient_last_name": "Müller",
  "recipient_company_name": "Müller Handels GmbH",
  "recipient_street": "Mariahilfer Straße",
  "recipient_house_no": "74/2",
  "recipient_address_details": "Top 12, Klingel: Müller",
  "recipient_zip": "1060",
  "recipient_city": "Wien",
  "recipient_country": "AT",
  "recipient_phone": "+436601234567",
  "recipient_email": "[email protected]",

  // PUDO (Pickup & Dropoff Point) Address Data - only for PUDO
  "pudo_id": "carrier_pudo_id",

  // Shipment & Order Data
  "reference_number": "your_unique_shipment_reference",
  "order": {
    "order_id": "your_order_id",
    "order_url": "https://www.your_order_url.at",
    "order_date": "2025-11-21T21:59:23.346Z",
    "boarding_complete": true,
    "language": "de"
  },

  // Base Shipping Label Specification
  "format": "zpl",
  "carrier": {
    "name": "dpd",
    "country": "at"
  },
  "carrier_service": "standard",
  "carrier_service_id": "carrier_product_service",
  "return_parcel": "outbound",
  "weight": 3,
  "dimensions": {
    "height": 30,
    "length": 20,
    "width": 20
  }
}

{
  "reference_number": "your_unique_shipment_reference",
  "tracking_code": "061234567890123",
  "outbound": {
    "label_url": "https://api-uat.sevensenders.com/v2/label-download/12345678",
    "shipment_id": "123456789",
    "tracking_code": "061234567890123",
    "print_format": "A6",
    "mime_type": "application/octet-stream",
    "pickup_point_selected": false,
    "return_address": {
      "firstName": "Your Name",
      "lastName": "c/o Seven Senders",
      "company": null,
      "phone": null,
      "email": null,
      "street": "Return Street 12",
      "streetNo": null,
      "zipCode": "1000",
      "city": "Wien",
      "country": "AT",
      "addressDetails": null,
      "province": null
    },
    "carrier": {
      "name": "dpd",
      "country": "AT"
    }
  },
  "goods_value": null,
  "goods_value_currency": null,
  "local_delivery": false,
  "return": null
}

ℹ️
The POST Label response includes core information about the created label, such as the tracking_code and the label_url for downloading it.

ℹ️
If a Returns label is requested the existing return object in the response is populated with the corresponding return-label data (see here)

ℹ️
The shipment_id is required when processing customs with Seven Senders and creating the associated customs shipment.

Step 3: GET Labels to Download the Generated Carrier Label

https://api-uat.sevensenders.com/label-download/{label_id}

https://api.sevensenders.com/label-download/{label_id}

Download generated Carrier Label via GET Labels Request

In the example below, the carrier label created in the previous step is downloaded. The label_url is returned in the response of the POST /labels request and should be retrieved from there.

https://api-uat.sevensenders.com/label-download/12345678

^XA
^CI28
^PW600
^LL900
^FX ======================
^FX (Recipient)
^FX ======================
^CF0,40
^FO40,40^FDAnna Müller^FS
^FO40,90^FDMüller Handels GmbH^FS
^FO40,140^FDMariahilfer Straße 74/2^FS
^FO40,190^FDTop 12, Klingel: Müller^FS
^FO40,240^FD1060 Wien^FS
^FO40,290^FDAT^FS
^FO40,340^FD+43 660 1234567^FS
^FO40,390^[[email protected]](mailto:[email protected])^FS
^FO20,440^GB560,3,3^FS
^FX ======================
^FX (Return Address)
^FX ======================
^CF0,35
^FO40,470^FDReturn to:^FS
^CF0,32
^FO40,520^FDYour Name^FS
^FO40,560^FDc/o Seven Senders^FS
^FO40,600^FDReturn Street 12^FS
^FO40,640^FD1000 Wien^FS
^FO40,680^FDAT^FS
^FO20,730^GB560,3,3^FS
^FX ======================
^FX Parcel Details
^FX ======================
^CF0,32
^FO40,770^FDService: Standard (DPD AT)^FS
^FO40,810^FDMaße (LxBxH): 20 × 20 × 30 cm^FS
^FO40,850^FDGewicht: 3 kg^FS
^XZ

ℹ️
Please note that the label shown in the example response is not an actual carrier label. It is provided solely for demonstration purposes.