Virtual Printing with PrintNode

This guide shows how to print Sendify shipping documents directly to a local or network printer using PrintNode and the /shipments/print endpoint.

Prerequisites#

1. Finish the Getting Started guide – you need a valid X-API-KEY and at least one booked shipment.
2. Download and install the PrintNode Client on the computer that can access your printers.
3. Request PrintNode credentials from your Sendify sales representative or e-mail api@sendify.com.
4. Log in to the PrintNode Client – your printers will appear in the API after a few seconds.

1. List available printers#

curl -X GET https://app.sendify.se/external/v1/printers \
  -H 'X-API-KEY: $YOUR_API_KEY'

Example response:

{
  "printers": [
    {
      "id": "prn-123",
      "name": "Office Zebra ZP450",
      "description": "4×6 label printer at reception"
    },
    {
      "id": "prn-456",
      "name": "A4 Laser",
      "description": "Back-office multi-function device"
    }
  ]
}

Take note of the id for the printer you want to target (e.g. "prn-123").

2. Print documents#

Use the /shipments/print endpoint to send documents straight to a printer via PrintNode.

Example: Print to a printer via PrintNode#

curl -X POST https://app.sendify.se/external/v1/shipments/print \
  -H 'X-API-KEY: $YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
        "shipment_ids": ["YOUR_SHIPMENT_ID"],
        "document_type": "label",
        "label_layout": "printer",
        "output_format": "printer",
        "printer_id": "PRINTER_ID"
      }'

The endpoint will also return the output_url

{ "output_url": "OUTPUT_URL" }

Label layout tips

• printer – one 4×6 label per page (thermal printers)
• 1x2, 3x1, 2x2, a4 – multi-label or A4 layouts

3. Quick recap#

1. Install & log in to the PrintNode Client.
2. Call GET /printers → copy printer_id.
3. Call POST /shipments/print with output_format: "printer".
4. Profit – automated label printing!