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

# Update customer loyalty status



## OpenAPI

````yaml /loyalty/storefront-api-swagger.json post /loyalty/cp/api/update-customer-status
openapi: 3.0.1
info:
  description: ''
  title: Storefront APIs
  version: 0.0.1
servers:
  - url: https://loyalty-admin.appstle.com
security: []
tags:
  - description: >-
      Storefront APIs for the signed-in customer to enroll, enable the loyalty
      program, view their loyalty profile, sync metafields, and update profile
      attributes.
    name: Customer Enrollment & Profile
  - description: >-
      Storefront APIs for the signed-in customer to view point transactions,
      claim social-media reward points, and record store visits.
    name: Points & Earn Rules
  - description: >-
      Storefront APIs for the signed-in customer to redeem loyalty points for
      rewards or discount codes.
    name: Redemptions & Discount Codes
  - description: >-
      Storefront APIs for managing the signed-in customer's referral activity:
      generating referral URLs, sending invites, viewing referral history, and
      accepting referral offers.
    name: Referrals
  - description: >-
      Storefront APIs for the signed-in customer to submit product reviews and
      retrieve existing reviews for a product.
    name: Reviews
  - description: >-
      Storefront APIs for retrieving product and collection data, proxied
      through the Shopify Storefront API for loyalty widgets.
    name: Product Catalog
paths:
  /loyalty/cp/api/update-customer-status:
    post:
      tags:
        - Customer Enrollment & Profile
      summary: Update customer loyalty status
      operationId: updateCustomerStatus
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CustomerBirthDateRequestVM'
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Customer'
          description: Customer status updated successfully
        '400':
          description: Invalid customer status
        '401':
          description: Customer not authenticated
components:
  schemas:
    CustomerBirthDateRequestVM:
      description: Customer birth date update request containing the date of birth
      example:
        customerId: 0
        dob: '2026-01-12'
        status: ACTIVE
      properties:
        customerId:
          description: Unique identifier of the customer
          example: 0
          format: int64
          type: integer
        dob:
          description: Customer date of birth
          example: '2026-01-12'
          format: date
          type: string
        status:
          description: Customer loyalty status
          enum:
            - ACTIVE
            - INACTIVE
            - EXCLUDED
            - EXCLUDED_BY_CUSTOMER
            - ACTIVE
            - INACTIVE
            - EXCLUDED
            - EXCLUDED_BY_CUSTOMER
          type: string
      type: object
    Customer:
      properties:
        availablePoints:
          format: double
          type: number
        availableStoreCredits:
          format: double
          type: number
        createAt:
          format: date-time
          type: string
        customerId:
          format: int64
          type: integer
        displayName:
          type: string
        dob:
          format: date
          type: string
        email:
          type: string
        emailBouncedOrFailed:
          type: boolean
        emailSetting:
          type: string
        enableEmail:
          type: boolean
        enableEmailMarketing:
          type: boolean
        enableSmsMarketing:
          type: boolean
        firstName:
          type: string
        id:
          format: int64
          type: integer
        isDeletedFromShopify:
          type: boolean
        lastActivity:
          format: date-time
          type: string
        lastMonthlyReminderSentDate:
          format: date-time
          type: string
        lastName:
          type: string
        lastRewardExpiryReminderSentDate:
          format: date-time
          type: string
        loyaltyProgramEnabled:
          type: boolean
        ordersCount:
          format: int32
          type: integer
        pendingPoints:
          format: double
          type: number
        phone:
          type: string
        redeemLimit:
          format: int64
          type: integer
        redeemLimitOnce:
          format: int64
          type: integer
        redeemedPoints:
          format: double
          type: number
        shop:
          type: string
        skipReview:
          type: boolean
        spentAmount:
          format: double
          type: number
        status:
          enum:
            - ACTIVE
            - INACTIVE
            - EXCLUDED
            - EXCLUDED_BY_CUSTOMER
          type: string
        storeCreditAccountId:
          type: string
        tags:
          type: string
        token:
          type: string
        updatedSettings:
          type: string
        vipAssignType:
          enum:
            - MANUAL
            - AUTO_RENEWAL
            - RENEWAL_ON_HIGHER_TIER
          type: string
        vipTier:
          type: string
        vipTierAmount:
          format: double
          type: number
        vipTierExpiredAt:
          format: date-time
          type: string
        vipTierId:
          format: int64
          type: integer
        vipTierSummary:
          type: string
      required:
        - availablePoints
        - createAt
        - customerId
        - pendingPoints
        - shop
      type: object

````