> ## Documentation Index
> Fetch the complete documentation index at: https://claimsdesk-871aefc7.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Creates a new Policy record.



## OpenAPI

````yaml POST /api/v1/Policies
openapi: 3.0.4
info:
  title: ClaimsDesk API v1.0
  description: Core claims engine and workflow endpoints.
  version: '1.0'
servers:
  - url: http://claimsdesk.runasp.net
    description: Production / Demo Server
security:
  - AppId: []
    ApiKey: []
tags:
  - name: Users
    x-group: User Management
    description: Manage platform users, roles, branches, and approvals.
  - name: Roles
    x-group: Access Control
    description: System roles.
  - name: Permissions
    x-group: Access Control
    description: Platform feature permissions and privileges.
  - name: RolePermissions
    x-group: Access Control
    description: Mapping permissions to user roles.
  - name: Organizations
    x-group: Tenant & Organization
    description: Manage corporate clients and tenant organizations.
  - name: Branches
    x-group: Tenant & Organization
    description: Branch offices and location entities.
  - name: Customers
    x-group: Policyholders & Members
    description: Primary customer profiles and policyholder details.
  - name: Members
    x-group: Policyholders & Members
    description: Covered members, beneficiaries, and dependents.
  - name: Policies
    x-group: Insurance Policies
    description: Core policy lifecycle, terms, coverage limits, and entitlement checks.
  - name: PolicyContributions
    x-group: Insurance Policies
    description: Policy premium payments, contributions, and transaction receipts.
  - name: Subscriptions
    x-group: Subscriptions & Licensing
    description: Tenant subscription plans and billing tiers.
  - name: LicensePools
    x-group: Subscriptions & Licensing
    description: Organizational license allocations and capacity quotas.
  - name: UserLicenses
    x-group: Subscriptions & Licensing
    description: Direct assignment of user seats and activation keys.
  - name: ApiKeys
    x-group: Developer & Security
    description: Tenant integration keys and machine-to-machine authentication tokens.
  - name: AuditTrails
    x-group: Developer & Security
    description: System audit logs, event tracing, and compliance trails.
  - name: Reports
    x-group: Analytics & Reporting
    description: Reporting engine, live preview calculation, and file export (PDF/Excel).
paths:
  /api/v1/Policies:
    post:
      tags:
        - Policies
      summary: Creates a new Policy record.
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreatePolicyDto'
          text/json:
            schema:
              $ref: '#/components/schemas/CreatePolicyDto'
          application/*+json:
            schema:
              $ref: '#/components/schemas/CreatePolicyDto'
      responses:
        '200':
          description: OK
          content:
            text/plain:
              schema:
                $ref: '#/components/schemas/PolicyDto'
            application/json:
              schema:
                $ref: '#/components/schemas/PolicyDto'
            text/json:
              schema:
                $ref: '#/components/schemas/PolicyDto'
components:
  schemas:
    CreatePolicyDto:
      required:
        - coverageType
        - deductibleAmount
        - endDate
        - memberId
        - organizationId
        - policyNumber
        - premiumAmount
        - startDate
        - sumInsured
      type: object
      properties:
        organizationId:
          type: integer
          format: int32
        memberId:
          type: integer
          format: int32
        policyNumber:
          maxLength: 50
          minLength: 1
          type: string
        coverageType:
          maxLength: 100
          minLength: 1
          type: string
        sumInsured:
          maximum: 1000000000
          minimum: 0
          type: number
          format: double
        deductibleAmount:
          maximum: 1000000000
          minimum: 0
          type: number
          format: double
        premiumAmount:
          maximum: 1000000000
          minimum: 0
          type: number
          format: double
        currencyCode:
          maxLength: 10
          type: string
          nullable: true
        paymentFrequency:
          $ref: '#/components/schemas/PremiumPaymentFrequency'
        startDate:
          type: string
          format: date-time
        endDate:
          type: string
          format: date-time
        status:
          $ref: '#/components/schemas/PolicyStatus'
      additionalProperties: false
    PolicyDto:
      type: object
      properties:
        id:
          type: integer
          format: int32
        organizationId:
          type: integer
          format: int32
        organizationName:
          type: string
          nullable: true
        memberId:
          type: integer
          format: int32
        memberNumber:
          type: string
          nullable: true
        memberFullName:
          type: string
          nullable: true
        policyNumber:
          type: string
          nullable: true
        coverageType:
          type: string
          nullable: true
        sumInsured:
          type: number
          format: double
        deductibleAmount:
          type: number
          format: double
        premiumAmount:
          type: number
          format: double
        currencyCode:
          type: string
          nullable: true
        paymentFrequency:
          $ref: '#/components/schemas/PremiumPaymentFrequency'
        startDate:
          type: string
          format: date-time
        endDate:
          type: string
          format: date-time
        status:
          $ref: '#/components/schemas/PolicyStatus'
        createdAt:
          type: string
          format: date-time
        updatedAt:
          type: string
          format: date-time
          nullable: true
      additionalProperties: false
    PremiumPaymentFrequency:
      enum:
        - 1
        - 2
        - 3
        - 4
        - 5
      type: integer
      format: int32
    PolicyStatus:
      enum:
        - 1
        - 2
        - 3
        - 4
        - 5
      type: integer
      format: int32
  securitySchemes:
    AppId:
      type: apiKey
      description: App ID authentication. Enter your App ID below.
      name: X-App-Id
      in: header
    ApiKey:
      type: apiKey
      description: API Key authentication. Enter your key below.
      name: X-Api-Key
      in: header

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.