---
title: "Changes to Create an Insurance Policy"
method: POST
path: "/2024-09/insurances/policies"
---

# Changes to Create an Insurance Policy

`POST /2024-09/insurances/policies`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 1 of 2 revisions.

- **2026-11-03** `b47b54b748a7`: 4 breaking, 13 warning, 14 info

## Changes

- **2026-11-03** `b47b54b748a7`: 4 breaking, 13 warning, 14 info
  - the request property `allOf[#/components/schemas/TrackingCreate]/origin_address/contact_name` became not nullable
  - the request property `allOf[#/components/schemas/TrackingCreate]/origin_address/state` became not nullable
  - the response property `insurance_policy/easyship_shipment_id` became nullable for the status `201`
  - the response property `insurance_policy/source` became nullable for the status `201`
  - added the new `accepted` enum value to the `insurance_policy/claim_state` response property for the response status `201`
  - added the new `active` enum value to the `insurance_policy/state` response property for the response status `201`
  - added the new `awaiting` enum value to the `insurance_policy/state` response property for the response status `201`
  - added the new `canceled` enum value to the `insurance_policy/state` response property for the response status `201`
  - added the new `closed` enum value to the `insurance_policy/claim_state` response property for the response status `201`
  - added the new `expired` enum value to the `insurance_policy/state` response property for the response status `201`
  - added the new `filed` enum value to the `insurance_policy/claim_state` response property for the response status `201`
  - added the new `in_progress` enum value to the `insurance_policy/claim_state` response property for the response status `201`
  - added the new `not_started` enum value to the `insurance_policy/claim_state` response property for the response status `201`
  - added the new `refund_completed` enum value to the `insurance_policy/claim_state` response property for the response status `201`
  - added the new `refund_failed` enum value to the `insurance_policy/claim_state` response property for the response status `201`
  - added the new `refund_initiated` enum value to the `insurance_policy/claim_state` response property for the response status `201`
  - added the new `rejected` enum value to the `insurance_policy/claim_state` response property for the response status `201`
  - added the new optional request property `allOf[#/components/schemas/TrackingCreate]/destination_address/allOf[#/components/schemas/DestinationAddress]/line_3`
  - added the new optional request property `allOf[#/components/schemas/TrackingCreate]/origin_address/company_name`
  - added the new optional request property `allOf[#/components/schemas/TrackingCreate]/origin_address/contact_email`
  - added the new optional request property `allOf[#/components/schemas/TrackingCreate]/origin_address/country_alpha2`
  - added the new optional request property `allOf[#/components/schemas/TrackingCreate]/origin_address/line_3`
  - the request property `allOf[#/components/schemas/TrackingCreate]/origin_address/contact_phone` became nullable
  - the request property `allOf[#/components/schemas/TrackingCreate]/origin_address/postal_code` became nullable
  - added the optional property `insurance_policy/claim_valid_from` to the response with the `201` status
  - added the optional property `insurance_policy/claim_valid_until` to the response with the `201` status
  - added the optional property `insurance_policy/courier_name` to the response with the `201` status
  - added the optional property `insurance_policy/insurance_valid_from` to the response with the `201` status
  - added the optional property `insurance_policy/insurance_valid_until` to the response with the `201` status
  - added the optional property `insurance_policy/platform_order_id` to the response with the `201` status
  - added the optional property `insurance_policy/policy_type` to the response with the `201` status

---

[Operation](https://skmtc.dev/easyship/apis/easyship-public-api/docs/2024-09/insurances/policies/post.md) - [API](https://skmtc.dev/easyship/apis/easyship-public-api.md) - [Page](https://skmtc.dev/easyship/apis/easyship-public-api/changes/2024-09/insurances/policies/post)