Couriers Please Guide | ShipEngine

ShipEngine is becoming ShipStation API

Over the next few months you'll notice the ShipEngine website, documentation portal, and dashboard being rebranded as ShipStation API. For our ShipEngine customers, you don't need to take any action or change any of your integrations in any way. All endpoints will remain the same and continue to function as they always have.

To learn more about what's coming, review our New ShipStation API page.

CouriersPlease

CouriersPlease offers domestic and international services to accounts shipping from Australia.

This guide provides developers with the details needed to build CouriersPlease shipping capabilities into your ShipStation API workflows.

If you are using or plan to use the CouriersPlease services included with ShipStation API, rather than connecting your own CouriersPlease account, see our CouriersPlease from ShipStation guide.

Requirements

Property	Type	Required?	Description
`nickname`	string	required	Used to identify your account in ShipStation API
`account_number`	string	required	Your Couriers Please account number
`api_secret`	string	required	Your Couriers Please API secret
`add_ship_date_during_label_creation`	boolean	Optional	Add shipment date during label creation
`skip_rating_during_label_creation`	boolean	Optional	Skip rating during label creation

Shipping Requirements

Weight and dimensions are required for all shipments.
Ship From address must have both a first and last name.
Ship To email address is required for all shipments.

Connect Account

You can connect a CouriersPlease account using the POST method to the /v1/connections/carriers/ endpoint, or via the ShipStation API Dashboard.

Connect via Endpoint

carrier_name: couriers_please

POST /v1/connections/carriers/:carrier_name

Sample request:

POST /v1/connections/carriers/couriers_please HTTP/1.1
{
  "nickname": "My Couriers Please account",
  "account_number": "123456789",
  "api_secret": "mycouriersplease-api-secret"
}

A successful connection will return a response with the carrier_id, which you'll use for any requests for this account going forward.

Rates

CouriersPlease supports rate shopping with ShipStation API.

Service Details

Available CouriersPlease services are provided below. Please note that carriers may update their available services at any time. To ensure you are always using valid services, you can use the list carrier services endpoint at any time.

Domestic Services

Service	API Code
DSL - Domestic Priority - Signature Required	`couriers_please_domestic_priority`
RSL - Domestic Off Peak - Signature Required	`couriers_please_off_peak`
GEC - Gold Domestic - Signature Required	`couriers_please_gold_domestic`
CouriersPlease Road Express	`couriers_please_road_express`
CouriersPlease 500 Gram Satchel	`couriers_please_500g_satchel`
... (more services omitted for brevity) ...

International Services

Service	API Code
SAVW - International Saver	`couriers_please_international_saver`
EXPW - International Express	`couriers_please_international_express`
... (more services omitted for brevity) ...

Return Services

CouriersPlease supports the following services for return labels:

Service	API Code
49 - Road Express - Returns	`couriers_please_returns`
RDPE5 - Returns Pickup	`couriers_please_returns_pickup`
RDOE5 - Returns Drop Off	`couriers_please_returns_drop_off`

Delivery Confirmation

Confirmation Type	API Code	Description
Authority to leave	`none`	No confirmation requested.
No authority to leave	`signature`	Signature is required for the shipment to be delivered.

Advanced Options

CouriersPlease supports certain advanced options, which you can add to the shipment object when creating a shipment or label.

Option	Type	Default Value	Description
`dangerous_goods`	boolean	`false`	Indicates if dangerous goods are present in the shipment.

Dangerous Goods

Use the dangerous_goods property in the advanced_options object to mark the shipment as containing dangerous goods. No additional properties are required by the carrier at this time.

Manifests

CouriersPlease does not require manifesting your shipments.

Scheduling Pickups

CouriersPlease does not support scheduling pickups using ShipStation API.

Service Points (PUDO)

CouriersPlease drop off services support dropping off at a service point.

Tracking

CouriersPlease supports receiving tracking updates. Review our Track a Package guides for details on tracking with the ShipStation API.

Disconnecting Your Couriers Please Account

See the Disconnect section in our Delete a Carrier page for the process of deleting or disconnecting a carrier from ShipStation API.