# Create shipping label

Creates a shipping label. The labelData field returned in the response is a base64 encoded PDF value. You can decode and save the output as a PDF file to retrieve a printable label.

IMPORTANT: You must have at least one active Manual Store on your ShipStation account to create labels with this endpoint.

Endpoint: POST /shipments/createlabel
Version: 1.0.0
Security: basicAuth

## Request fields (application/json):

  - `carrierCode` (string, required)
    Carrier code
    Example: "fedex"

  - `serviceCode` (string, required)
    Service code
    Example: "fedex_ground"

  - `packageCode` (string, required)
    Package type code
    Example: "package"

  - `confirmation` (string)
    Delivery confirmation type
    Enum: "none", "delivery", "signature", "adult_signature", "direct_signature"

  - `shipDate` (string, required)
    Ship date
    Example: "2014-04-03"

  - `weight` (object, required)
    Weight measurement

  - `weight.value` (number, required)
    Weight value
    Example: 24

  - `weight.units` (string, required)
    Weight unit of measurement
    Enum: "pounds", "ounces", "grams"

  - `dimensions` (any)

  - `shipFrom` (object, required)
    Physical address for shipping or billing

  - `shipFrom.name` (string)
    Name of the recipient
    Example: "John Doe"

  - `shipFrom.company` (any)
    Company name
    Example: "Acme Corp"

  - `shipFrom.street1` (string)
    First line of the street address
    Example: "123 Main St"

  - `shipFrom.street2` (any)
    Second line of the street address
    Example: "Apt 4B"

  - `shipFrom.street3` (any)
    Third line of the street address
    Example: "Building B"

  - `shipFrom.city` (string)
    City name
    Example: "Austin"

  - `shipFrom.state` (string)
    State or province code
    Example: "TX"

  - `shipFrom.postalCode` (string)
    Postal or ZIP code
    Example: "78701"

  - `shipFrom.country` (string)
    Two-letter ISO country code
    Example: "US"

  - `shipFrom.phone` (any)
    Phone number
    Example: "512-555-1234"

  - `shipFrom.residential` (any)
    Whether the address is residential
    Example: true

  - `shipFrom.addressVerified` (any)
    Address verification status
    Example: "Address validated successfully"

  - `shipTo` (object, required)
    Physical address for shipping or billing

  - `insuranceOptions` (any)

  - `internationalOptions` (any)

  - `advancedOptions` (any)

  - `testLabel` (boolean)
    Whether to create a test label

## Response 200 fields (application/json):

  - `shipmentId` (integer)
    Example: 123456789

  - `shipmentCost` (number)
    Example: 8.25

  - `insuranceCost` (number)

  - `trackingNumber` (string)
    Example: "9405511899564298878910"

  - `labelData` (string)
    Base64 encoded PDF label data
    Example: "JVBERi0xLjQKJeLjz9MKMiAwIG9iago..."

  - `formData` (any)
    Base64 encoded form data if applicable

## Response 400 fields (application/json):

  - `message` (string)
    Example: "Invalid request parameters"

## Response 401 fields (application/json):

  - `message` (string)
    Example: "Invalid API credentials"

## Response 500 fields (application/json):

  - `message` (string)
    Example: "An internal error occurred"