> ## Documentation Index
> Fetch the complete documentation index at: https://knowledge.bitbybit.studio/llms.txt
> Use this file to discover all available pages before exploring further.

# Create Reward Option

> Create a reward option and corresponding Shopify price rule.



## OpenAPI

````yaml POST /bitlogin/api/open/v1/loyalty/reward-options
openapi: 3.1.0
info:
  title: bitLogin Loyalty API
  description: >-
    Loyalty configuration endpoints for bitLogin (integration toggle, point
    conversion, and reward options).
  version: 1.0.0
servers:
  - url: https://api.bitbybit.studio
    description: Production
security:
  - ApiKeyAuth: []
paths:
  /bitlogin/api/open/v1/loyalty/reward-options:
    post:
      tags:
        - Loyalty - bitLogin
      summary: Create reward option
      description: Create a reward option and corresponding Shopify price rule.
      operationId: createRewardOption
      parameters: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/RewardOptionInput'
      responses:
        '201':
          description: Created
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RewardOption'
components:
  schemas:
    RewardOptionInput:
      type: object
      required:
        - rewardName
        - costToRedeem
        - discountType
        - discountValue
        - expirationPreset
      properties:
        rewardName:
          type: string
        costToRedeem:
          type: integer
          minimum: 1
        discountType:
          type: string
          enum:
            - fixed_amount
            - percentage
            - free_shipping
        discountValue:
          description: Decimal string up to 4 decimals. Percentage must be 1-100.
          oneOf:
            - type: string
              description: Decimal string up to 4 decimals. Percentage must be 1-100.
            - type: number
              description: Decimal number up to 4 decimals. Percentage must be 1-100.
        voucherPrefix:
          type: string
          nullable: true
        minimumPurchaseAmount:
          description: Decimal string up to 4 decimals.
          oneOf:
            - type: string
              description: Decimal string up to 4 decimals.
            - type: number
              description: Decimal number up to 4 decimals.
        expirationPreset:
          type: string
          enum:
            - NO_EXPIRATION
            - SEVEN_DAYS
            - THIRTY_DAYS
            - NINETY_DAYS
            - ONE_YEAR
    RewardOption:
      type: object
      properties:
        id:
          type: string
        companyId:
          type: integer
        rewardName:
          type: string
        costToRedeem:
          type: integer
        discountType:
          type: string
          enum:
            - fixed_amount
            - percentage
            - free_shipping
        discountValue:
          type: number
        voucherPrefix:
          type: string
          nullable: true
        minimumPurchaseAmount:
          type: number
        expirationPreset:
          type: string
          enum:
            - NO_EXPIRATION
            - SEVEN_DAYS
            - THIRTY_DAYS
            - NINETY_DAYS
            - ONE_YEAR
        priceRuleId:
          type: string
        startsAt:
          type: string
          format: date-time
        endsAt:
          type:
            - string
            - 'null'
          format: date-time
        createdAt:
          type: string
          format: date-time
        updatedAt:
          type: string
          format: date-time
  securitySchemes:
    ApiKeyAuth:
      description: API key for authentication. Create one in Settings > Developer.
      name: x-api-key
      in: header
      type: apiKey

````