Create Policy
Creates a new policy directly, primarily for historical imports where policies need to be created without going through the quote→bind wizard flow.
Workflow:
- Create insureds first via
POST /insureds - Create the policy with insured references via this endpoint
- The endpoint creates insured snapshots with the provided ratingInfo
Required fields:
referenceId- Policy number (must be unique)startsAtDate,endsAtDate- Coverage datestype- Policy type (C, N, T, O, P, S, Q, R, A)billingPeriod- Billing frequencyexposures- At least one exposure with exactly one havingrole: "primary"coverages- At least one coverage with validcoverageTypeId
Required permission: company.policy:create
Authorizations
API key authentication. Include your API key in the Authorization header.
Path Parameters
Company identifier
Body
Policy number (must be unique per company)
Policy effective start date (YYYY-MM-DD)
Policy effective end date (YYYY-MM-DD)
Type of policy:
- C: Claims Made
- N: New Claims Made
- T: Tail
- O: Occurrence
- P: Occurrence + Claims Made
- S: Split (Half Claims Made/Occurrence)
- Q: Quota Share
- R: Occurrence + Claims Made + Tail
- A: Claims Made (Alternative)
C, N, T, O, P, S, Q, R, A Billing period for the policy
doNotSendBill, annual, quarterly, monthly Exposures (insureds) to add to the policy. Exactly one must have role "primary".
1Coverages to add to the policy
1IANA timezone for coverage (e.g., "America/New_York"). Defaults to company default.
Policy description
Total premium in dollars (overrides rating calculation)
ID of an existing broker to associate with this policy. Use POST /brokers to create a broker first.
Custom data fields for this policy. Keys must match fields from GET /policies/configuration. Values are strings or numbers.
Response
Policy created successfully
The ID of the created policy