---
title: "Add/Update Customer Preferences"
method: POST
path: "/customer/preferences"
---

# Add/Update Customer Preferences

`POST /customer/preferences`

Preferences are custom fields created under the preferences category which helps in capturing specific interests of a customer. Example: favorite color, favorite brand. This API allows you to set or update preferences of a customer.

## Query parameters

- `format` 'json' | 'xml'

## Request body

- object
  - `RAW_BODY` string, json

## Response `200`

200

- object
  - `response` object
    - `status` object
      - `success` string
      - `code` string
      - `message` string
    - `customers` object
      - `customer` object
        - `user_id` string
        - `mobile` string
        - `email` string
        - `external_id` string
        - `custom_fields` object
          - `field` object[]
            - `name` string
            - `value` string
        - `store` object
          - `id` string
          - `code` string
          - `name` string
          - `status` string
        - `item_status` object
          - `success` string
          - `code` string
          - `message` string

## Other responses

- `400` — 400

---

[API](https://skmtc.net/capillarytech/apis/sample-api.md) · [All operations](https://skmtc.net/capillarytech/apis/sample-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/capillarytech/sample-api/versions/de241f2ed9b3/schema)