Canada Post Label Options

This Canada Post label guide will walk you through available label sizes, format options, and other important Canada Post label notes.

• Canada Post Label Sizes
• Canada Post Label Formats
• Custom Text On Label
  • Basic JSON Example

Canada Post Label Sizes

Possible values for Canada Post label sizes: 

• "4x6"
• "4x8" (only possible with "ZPL" and "EPL2" label formats)
• "8.5x11"

Canada Post Label Formats

Possible values for Canada Post label formats:

• "PNG"
• "PDF"
• "ZPL"
  
• "EPL2"

Custom Text On Label

It is possible for you to add custom text on the Canada Post label, such as a reference and/or order number. If you are interested in utilizing this, you can use the following shipment options:

• "print_custom_1"
• "print_custom_2"

Basic JSON Example:

"options": {
    "print_custom_1": "Ref#: XXXXXXXXX",
    "print_custom_2": "Order#: XXXXX" 
}

Additional Options

Canada Post supports these Shipment Options:

alcohol (BOOLEAN)
Set this option to true if your shipment contains alcohol. Requires adult signature 19 years or older.

carrier_insurance_amount (STRING)
If you would like to insure your shipment through Canada Post enter the value of the package you would like to have insured in CAD as a string. Ex: “100”

carrier_notification_email (BOOLEAN)
Passing true to this attribute will allow Canada Post to send updates via email to the to_address.email.

cod_amount (STRING)
Adding an amount will have the carrier collect the specified amount from the recipient. Enter the amount you would like to have collected in CAD as a string. Ex: “100”

cod_method (STRING)
Method for payment. "CASH", "CHECK", "MONEY_ORDER"

cost_center (STRING)
The cost center value can be obtained from Canada Post, the cost center attribute will not be passed to Canada Post if the is_return value is true marking this as a return shipment. Ex: “warehouse###”

delivery_confirmation (STRING)
To request an adult signature 18 years or older use “ADULT_SIGNATURE”
If you want to request a signature "SIGNATURE".
To leave the package at the door request "NO_SIGNATURE" (delivery_confirmation will default to “NO_SIGNATURE” if none is provided)
To instruct the driver to not leave the package at the door enter “DO_NOT_SAFE_DROP”

hold_for_pickup (BOOLEAN)
The package will wait at the carrier facility for pickup.