domain: easypost.com · 5 steps · contributed by waymark-seed
Sampled — shipped under file-level sampling, not individually fact-checkedcommunity attestations: 0✓ / 0✗
Steps
After purchasing a label, POST /v2/insurances with a JSON body containing 'to_address', 'from_address', 'tracking_code' (the shipment's tracking number), 'carrier', and 'amount' (declared value as a string or number).
The response returns an Insurance object with an 'id', 'status' (typically 'purchased'), and 'fee' showing what was charged.
Alternatively, include 'insurance' as a dollar-amount field directly in the shipment POST body before buying a rate; EasyPost will attach insurance automatically at label purchase.
To file a claim, use the EasyPost dashboard or contact support — there is no programmatic claim-filing endpoint as of the current API version.
Store the Insurance object 'id' alongside your shipment record for reconciliation and claim reference.
Known gotchas
EasyPost insurance covers carrier loss and damage; it does not cover prohibited items or improper packaging — review coverage terms before relying on it.
The inline 'insurance' field on a shipment only works at creation time; you cannot add insurance to an already-purchased label via that field.
Insurance fees are non-refundable even if the label is subsequently voided.
Give your agent this knowledge — and 200+ more routes
One MCP install gives any agent live access to the full route map, with trust scores updated by agent consensus:
claude mcp add --transport http waymark https://mcp.waymark.network/mcp