Parcel Insurance
Enable Shipsurance
Shipsurance is included by default, you just need to enable it! Here are the steps to do so!
- Log in to the ShipEngine Dashboard.
- Go to Connections, then Insurance.
- Toggle the 3rd Party Insurance option to on.
- Accept the Shipsurance Terms and Conditions in the pop-up window.
Adding Insurance Funds
You may need to auto-fund your account from time to time. For example, if you don't normally ship items over $100, and may want to add funds to insurance rather than keeping the account funded.
PATCH /v1/insurance/shipsurance/add_funds
Example Request
Example Response
Shipengine responds with an object showing the new balance in your account.
Check Your Insurance Balance
GET /v1/insurance/shipsurance/balance
Example Request
Example Response
Adding Insurance to a Shipment
When creating a label, you can declare the package value to ensure reimbursement if the package is lost or damaged in the
mail stream. Start by setting the insurance_provider
field to one of the following values:
Insurance Provider | Description |
---|---|
none (default) | The package will not be insured. Some carriers may still offer reimbursement up to a certain value. |
shipsurance | Purchase insurance from Shipsurance. You need to setup your billing info first. |
carrier | Get increased reimbursement coverage from the carrier based on the declared value of the package. |
third_party | The package is insured by a third-party insurance service, outside of ShipEngine. |
In addition to the insurance_provider
field, you will also need to set the insured_value
of each package in the shipment. For example:
Example Request
This is an example of a full request to create a label for a shipment that is insured.