@redotech/redo-api-schema 2.2.432 → 2.2.435

package/lib/openapi.d.ts

@@ -810,10 +810,10 @@ export interface components {
       /**
        * Created at
        * Format: date-time
-       * @description Timestamp when the customer was created.
+       * @description Timestamp when the customer was created. May be null for older customers created before this field was tracked.
        */
-      createdAt: string;
-      /** @description Custom field values as key-value pairs, where keys are field names and values can be strings, numbers, or booleans. */
+      createdAt?: string | null;
+      /** @description Custom field values as key-value pairs, where keys are field names and values can be strings, numbers, or booleans. DATE custom field values are returned as ISO 8601 datetime strings (e.g., "2026-01-15T12:00:00.000Z"), not Date objects. */
       customFields?: {
         [key: string]: string | number | boolean;
       };
@@ -834,9 +834,9 @@ export interface components {
       /**
        * Updated at
        * Format: date-time
-       * @description Timestamp when the customer was last updated.
+       * @description Timestamp when the customer was last updated. May be null for older customers created before this field was tracked.
        */
-      updatedAt: string;
+      updatedAt?: string | null;
     };
     /** @description Email subscription updates */
     "customer-subscription-email.schema": {
@@ -884,12 +884,19 @@ export interface components {
      */
     "customer-upsert-request.schema": {
       /**
-       * @description Custom field values as key-value pairs. Keys are field names and values can be strings, numbers, or booleans. New fields are created automatically if they don't exist yet.
+       * @description Custom field values as key-value pairs. Keys are field names and values can be strings, numbers, or booleans. The field type is determined automatically based on the value:
+       * - String values → STRING custom field
+       * - Number values → NUMBER custom field
+       * - Boolean values → BOOLEAN custom field
+       * - ISO 8601 datetime strings (e.g., "2026-02-24T12:15:00.000Z") → DATE custom field (auto-detected)
+       *
+       * If a field name does not already have a declaration, one is created automatically. For STRING fields, unique values are tracked as options (used for segment filtering dropdowns). NUMBER, BOOLEAN, and DATE fields do not track options.
        * @example {
        *   "subscription_source": "web",
        *   "status": "Active",
        *   "loyalty_points": 1250,
-       *   "vip_member": true
+       *   "vip_member": true,
+       *   "signup_date": "2026-02-24T12:15:00.000Z"
        * }
        */
       customFields?: {

package/lib/openapi.yaml

@@ -1943,7 +1943,7 @@ components:
         location:
           $ref: '#/components/schemas/customer-location.schema'
         customFields:
-          description: Custom field values as key-value pairs, where keys are field names and values can be strings, numbers, or booleans.
+          description: Custom field values as key-value pairs, where keys are field names and values can be strings, numbers, or booleans. DATE custom field values are returned as ISO 8601 datetime strings (e.g., "2026-01-15T12:00:00.000Z"), not Date objects.
           type: object
           additionalProperties:
             oneOf:
@@ -1955,25 +1955,28 @@ components:
               status: Active
               loyalty_points: 1250
               vip_member: true
+              signup_date: '2026-02-24T12:15:00.000Z'
         createdAt:
-          description: Timestamp when the customer was created.
+          description: Timestamp when the customer was created. May be null for older customers created before this field was tracked.
           format: date-time
           title: Created at
           examples:
             - '2026-02-20T18:30:00.000Z'
-          type: string
+          type:
+            - string
+            - 'null'
         updatedAt:
-          description: Timestamp when the customer was last updated.
+          description: Timestamp when the customer was last updated. May be null for older customers created before this field was tracked.
           format: date-time
           title: Updated at
           examples:
             - '2026-02-24T12:15:00.000Z'
-          type: string
+          type:
+            - string
+            - 'null'
       required:
         - id
         - email
-        - createdAt
-        - updatedAt
       title: Customer
       type: object
     customer-upsert-request.schema:
@@ -1998,7 +2001,14 @@ components:
         location:
           $ref: '#/components/schemas/customer-location.schema'
         customFields:
-          description: Custom field values as key-value pairs. Keys are field names and values can be strings, numbers, or booleans. New fields are created automatically if they don't exist yet.
+          description: |-
+            Custom field values as key-value pairs. Keys are field names and values can be strings, numbers, or booleans. The field type is determined automatically based on the value:
+            - String values → STRING custom field
+            - Number values → NUMBER custom field
+            - Boolean values → BOOLEAN custom field
+            - ISO 8601 datetime strings (e.g., "2026-02-24T12:15:00.000Z") → DATE custom field (auto-detected)
+
+            If a field name does not already have a declaration, one is created automatically. For STRING fields, unique values are tracked as options (used for segment filtering dropdowns). NUMBER, BOOLEAN, and DATE fields do not track options.
           type: object
           additionalProperties:
             oneOf:
@@ -2010,6 +2020,7 @@ components:
             status: Active
             loyalty_points: 1250
             vip_member: true
+            signup_date: '2026-02-24T12:15:00.000Z'
       required:
         - email
       title: Customer Upsert Request

package/package.json

@@ -31,5 +31,5 @@
       ]
     }
   },
-  "version": "2.2.432"
+  "version": "2.2.435"
 }