# Create customer policy (/docs/api-reference/customers/policies/create-customer-policy)



{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

Add an insurance policy to a customer's record.

**Medicare plan codes**: For `MA` and `MAPD`, `planCode` must be a CMS contract-style code starting with `H` or `R`. For `PDP`, it must start with `S`, `H`, `R`, `E`, or `X`. The three-digit segment is optional: send contract+plan only (`H3146-036`) and careCycle infers the segment from CMS reference data, defaulting to `-000` for non-segmented plans; a record is rejected only when the plan genuinely has multiple segments (include the segment to disambiguate). Dashes are optional in requests (`H1234001000` and `H1234-001-000` are accepted); careCycle stores the canonical dashed form. `MS` plan codes are carrier-specific and are not required to follow the CMS contract format.

<APIPage document="&#x22;../../apps/api/openapi/specs/openapi-public.yaml&#x22;" operations="[{&#x22;path&#x22;:&#x22;/v2/customers/{id}/policies&#x22;,&#x22;method&#x22;:&#x22;post&#x22;}]" />