---
title: "Create an Insurance Policy from Quote"
method: POST
path: "/2024-09/insurances/policies-from-quote"
tags: ["Insurance"]
---

# Create an Insurance Policy from Quote

`POST /2024-09/insurances/policies-from-quote`

> **Regional availability**: This endpoint is currently only available for US entities. Support for additional regions will be available in a future release.

Create an insurance policy from an existing quote.
The quote must be active and not expired.

Easyship relies on the tracking number and courier service name to register the shipment with the insurance provider.

Required authorization scope: `public.insurance_policy_3p:write`

> This API requires an updated contract with Easyship. Get in touch with your account manager or Easyship Support Team.

## Request body

- InsurancePolicyFromQuoteCreate
  - `policy` object, required
    - `quote_id` string, uuid, required — ID of the insurance quote to convert to a policy
    - `tracking_number` string, required — Shipment tracking number
    - `courier_service_name` string, required — Name of the courier service
    - `email_address` string, email, required — Email address for policy notifications
    - `policy_holder_type` 'buyer' | 'merchant' — Who holds the insurance policy. Defaults to "merchant" if not provided
    - `order_number` string, nullable — Your platform's order reference
    - `first_name` string, required — Policy holder first name
    - `last_name` string, required — Policy holder last name
    - `order_date` string, date — Date the order was placed
    - `ship_date` string, date — Date the shipment was dispatched
    - `phone` string — Policy holder phone number
    - `send_email` boolean — Whether to send a policy confirmation email
    - `shipping_address1` string — Shipping address line 1
    - `shipping_address2` string — Shipping address line 2
    - `shipping_city` string — Shipping city
    - `shipping_state` string — Shipping state or province
    - `shipping_zip` string — Shipping postal code
    - `shipping_country` string — Shipping country code (ISO 3166-1 alpha-2)
    - `billing_address1` string — Billing address line 1
    - `billing_address2` string — Billing address line 2
    - `billing_city` string — Billing city
    - `billing_state` string — Billing state or province
    - `billing_zip` string — Billing postal code
    - `billing_country` string — Billing country code (ISO 3166-1 alpha-2)

## Response `201`

Insurance policy successfully created from quote

- InsurancePolicyFromQuoteSingle — Insurance policy created from quote
  - `insurance_policy` InsurancePolicyFromQuote
    - `policy_id` string — Unique identifier for this insurance policy
    - `status` string — Policy creation status
    - `insured_value` number — Total declared value insured
    - `currency` 'AED' | 'AFN' | 'ALL' | 'AMD' | 'ANG' | 'AOA' | 'ARS' | 'AUD' | 'AWG' | 'AZN' | 'BAM' | 'BBD' | 'BDT' | 'BGN' | 'BHD' | 'BIF' | 'BMD' | 'BND' | 'BOB' | 'BRL' | 'BSD' | 'BTN' | 'BWP' | 'BYR' | 'BZD' | 'CAD' | 'CDF' | 'CHF' | 'CLF' | 'CLP' | 'CNY' | 'COP' | 'CRC' | 'CUC' | 'CUP' | 'CVE' | 'CZK' | 'DJF' | 'DKK' | 'DOP' | 'DZD' | 'EGP' | 'ERN' | 'ETB' | 'EUR' | 'FJD' | 'FKP' | 'GBP' | 'GEL' | 'GHS' | 'GIP' | 'GMD' | 'GNF' | 'GTQ' | 'GYD' | 'HKD' | 'HNL' | 'HRK' | 'HTG' | 'HUF' | 'IDR' | 'ILS' | 'INR' | 'IQD' | 'IRR' | 'ISK' | 'JMD' | 'JOD' | 'JPY' | 'KES' | 'KGS' | 'KHR' | 'KMF' | 'KPW' | 'KRW' | 'KWD' | 'KYD' | 'KZT' | 'LAK' | 'LBP' | 'LKR' | 'LRD' | 'LSL' | 'LTL' | 'LVL' | 'LYD' | 'MAD' | 'MDL' | 'MGA' | 'MKD' | 'MMK' | 'MNT' | 'MOP' | 'MRO' | 'MUR' | 'MVR' | 'MWK' | 'MXN' | 'MYR' | 'MZN' | 'NAD' | 'NGN' | 'NIO' | 'NOK' | 'NPR' | 'NZD' | 'OMR' | 'PAB' | 'PEN' | 'PGK' | 'PHP' | 'PKR' | 'PLN' | 'PYG' | 'QAR' | 'RON' | 'RSD' | 'RUB' | 'RWF' | 'SAR' | 'SBD' | 'SCR' | 'SDG' | 'SEK' | 'SGD' | 'SHP' | 'SKK' | 'SLL' | 'SOS' | 'SRD' | 'SSP' | 'STD' | 'SVC' | 'SYP' | 'SZL' | 'THB' | 'TJS' | 'TMT' | 'TND' | 'TOP' | 'TRY' | 'TTD' | 'TWD' | 'TZS' | 'UAH' | 'UGX' | 'USD' | 'UYU' | 'UZS' | 'VES' | 'VND' | 'VUV' | 'WST' | 'XAF' | 'XAG' | 'XAU' | 'XCD' | 'XDR' | 'XOF' | 'XPF' | 'YER' | 'ZAR' | 'ZMW' | 'BTC' | 'JEP' | 'EEK' | 'GHC' | 'MTL' | 'TMM' | 'YEN' | 'ZWD' | 'ZWL' | 'ZWN' | 'ZWR' — ISO-4217 three-letter alphabetic currency code (e.g. USD, EUR, GBP)
    - `insurance_fee` number — Fee charged for the insurance policy
    - `tracking_number` string — Shipment tracking number
    - `insurance_valid_from` string, date-time, nullable — When insurance coverage begins (ISO 8601)
    - `claim_window_opens` string, date-time, nullable — When the claim window opens (ISO 8601)
    - `claim_window_closes` string, date-time, nullable — When the claim window closes (ISO 8601)
  - `meta` Meta
    - `request_id` string — An unique ID represent the request.

## Other responses

- `422` — validation error

---

[API](https://skmtc.net/easyship/apis/easyship-public-api.md) · [All operations](https://skmtc.net/easyship/apis/easyship-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/easyship/easyship-public-api/revisions/71d737a5fcbf/schema)