> ## Documentation Index
> Fetch the complete documentation index at: https://www.commercengine.io/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Create shipping cost policy

> Create shipping cost policy



## OpenAPI

````yaml https://openapi.commercengine.io/ce-admin.json post /store/shipping-cost-policy
openapi: 3.1.0
info:
  title: CE Admin APIs
  version: '1.0'
  summary: Comprehensive admin interface for managing your e-commerce platform
  description: >-
    Complete administrative API suite for Commerce Engine, providing powerful
    tools to manage products, orders, customers, inventory, analytics, and
    system configuration. Designed for administrators and backend integrations
    requiring full platform control.
  license:
    name: All Rights Reserved
    url: https://www.commercengine.io/contact-us
  contact:
    email: support@commercengine.io
    url: https://www.commercengine.io/contact-us
    name: Support
servers:
  - url: https://staging.api.commercengine.io/api/v1/{store_id}/admin
    description: Staging Server
    variables:
      store_id:
        default: store_id
        description: Store ID
  - url: https://prod.api.commercengine.io/api/v1/{store_id}/admin
    description: Prod Server
    variables:
      store_id:
        default: store_id
        description: Store ID
security:
  - Authorization: []
tags:
  - name: Analytics
    description: Analytics
  - name: Catalog
    description: Catalog
  - name: Coupons & promotions
    description: Coupons & promotions
  - name: Customers
    description: Customers
  - name: Filter Options
    description: Filter Options
  - name: Inventories
    description: Inventories
  - name: Marketplace
    description: Marketplace
  - name: Marketplace Catalog
    description: Marketplace Catalog
  - name: Media Gallery
    description: Media Gallery
  - name: Metrics
    description: Metrics
  - name: Orders
    description: Orders
  - name: Payments
    description: Payments
  - name: Payouts
    description: Payouts
  - name: POS
    description: POS
  - name: POSAdmin
    description: Admin endpoints to be used as proxy in pos
  - name: Segments
    description: Segments
  - name: Shipping
    description: Shipping
  - name: SSE
    description: SSE
  - name: Store
    description: Store
  - name: Webhooks
    description: Webhooks
paths:
  /store/shipping-cost-policy:
    post:
      tags:
        - Store
      summary: Create shipping cost policy
      description: Create shipping cost policy
      operationId: update-shipping-policy
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ShippingCostPolicy'
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                  message:
                    type: string
                  content:
                    $ref: '#/components/schemas/ShippingCostPolicy'
components:
  schemas:
    ShippingCostPolicy:
      title: ShippingCostPolicy
      type: object
      required:
        - rules
        - default_action
      properties:
        rules:
          type: array
          items:
            $ref: '#/components/schemas/ShippingRule'
        default_action:
          $ref: '#/components/schemas/ShippingCostAction'
      additionalProperties: false
    ShippingRule:
      title: ShippingRule
      type: object
      required:
        - condition
        - action
      properties:
        condition:
          $ref: '#/components/schemas/ShippingCostCondition'
        action:
          $ref: '#/components/schemas/ShippingCostAction'
      additionalProperties: false
    ShippingCostAction:
      title: ShippingCostAction
      oneOf:
        - $ref: '#/components/schemas/FreeAction'
        - $ref: '#/components/schemas/FixedChargeAction'
        - $ref: '#/components/schemas/DiscountAction'
        - $ref: '#/components/schemas/DynamicAction'
    ShippingCostCondition:
      title: ShippingCostCondition
      type: object
      oneOf:
        - additionalProperties: false
          title: Order Total
          required:
            - order_total
          properties:
            order_total:
              $ref: '#/components/schemas/Comparison'
        - additionalProperties: false
          title: Shipping Mode
          required:
            - shipping_mode
          properties:
            shipping_mode:
              description: e.g. ["air","surface"]
              type: array
              items:
                type: string
        - additionalProperties: false
          title: Shipping Providers
          required:
            - providers
          properties:
            providers:
              description: e.g. ["dhl","fedex"]
              type: array
              items:
                type: string
    FreeAction:
      title: FreeAction
      type: object
      required:
        - type
      properties:
        type:
          type: string
          const: free
      additionalProperties: false
    FixedChargeAction:
      title: FixedChargeAction
      type: object
      required:
        - type
        - value
      properties:
        type:
          type: string
          const: fixed-charge
        value:
          description: Flat charge amount
          type: number
          minimum: 0
      additionalProperties: false
    DiscountAction:
      title: DiscountAction
      type: object
      required:
        - type
        - mode
        - value
      properties:
        type:
          type: string
          const: discount
        mode:
          type: string
          enum:
            - percent
            - absolute
        value:
          description: Percentage (0–100) or absolute amount off
          type: number
          minimum: 0
      additionalProperties: false
    DynamicAction:
      title: DynamicAction
      type: object
      required:
        - type
        - rounding
      properties:
        type:
          type: string
          const: dynamic
        rounding:
          $ref: '#/components/schemas/Rounding'
      additionalProperties: false
    Comparison:
      type: object
      oneOf:
        - minProperties: 1
          maxProperties: 2
          additionalProperties: false
          properties:
            gte:
              type: number
              minimum: 0
        - properties:
            gt:
              type: number
              minimum: 0
        - properties:
            lte:
              type: number
              minimum: 0
        - properties:
            lt:
              type: number
              minimum: 0
    Rounding:
      title: Rounding
      description: Define how to round the shipping cost
      type: object
      required:
        - unit
        - method
      properties:
        unit:
          type: number
          exclusiveMinimum: 0
        method:
          type: string
          enum:
            - nearest
            - ceil
            - floor
      additionalProperties: false
  securitySchemes:
    Authorization:
      type: http
      scheme: bearer

````