Klaviyo · Schema

ReviewCreateDTOResourceObject

MarketingEmailSMSCustomer DataEcommerceAutomation

Properties

Name Type Description
type object
attributes object
relationships object
View JSON Schema on GitHub

JSON Schema

klaviyo-reviewcreatedtoresourceobject-schema.json Raw ↑
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "#/components/schemas/ReviewCreateDTOResourceObject",
  "title": "ReviewCreateDTOResourceObject",
  "type": "object",
  "properties": {
    "type": {
      "$ref": "#/components/schemas/ReviewEnum"
    },
    "attributes": {
      "type": "object",
      "properties": {
        "review_type": {
          "description": "The type of this review -- either a review or a question",
          "type": "string",
          "example": "review",
          "enum": [
            "question",
            "rating",
            "review",
            "store"
          ]
        },
        "email": {
          "description": "The email of the author of this review",
          "type": "string",
          "example": "[email protected]"
        },
        "author": {
          "description": "The author of this review",
          "type": "string",
          "example": "John Doe"
        },
        "content": {
          "description": "The content of this review",
          "example": "This was an absolutely amazing t-shirt. I loved the color and the fit.",
          "type": "string"
        },
        "incentive_type": {
          "description": "The incentive type for the review",
          "type": "string",
          "enum": [
            "coupon_or_discount",
            "employee_review",
            "free_product",
            "loyalty_points",
            "other",
            "paid_promotion",
            "sweepstakes_entry"
          ],
          "nullable": true
        },
        "product": {
          "description": "The product associated with this review",
          "$ref": "#/components/schemas/ReviewProductExternalId",
          "nullable": true
        },
        "rating": {
          "description": "The rating of this review on a scale from 1-5. If the review type is \"question\", this field will be null.",
          "type": "integer",
          "example": 2,
          "enum": [
            1,
            2,
            3,
            4,
            5
          ],
          "nullable": true
        },
        "title": {
          "description": "The title of this review",
          "type": "string",
          "example": "Great product!",
          "nullable": true
        },
        "custom_questions": {
          "description": "Custom question and answers for the review",
          "type": "array",
          "items": {
            "$ref": "#/components/schemas/CustomQuestionDTO"
          },
          "example": [
            {
              "id": "9ff0d32e-0edb-4513-a6a5-12814a6cb755",
              "answers": [
                "M",
                "L"
              ]
            }
          ],
          "nullable": true
        },
        "images": {
          "description": "The list of images submitted with this review (represented as a list of urls or base-64 encoded data-uri). If there are no images, this field will be an empty list.",
          "type": "array",
          "items": {
            "type": "string"
          },
          "example": [
            "https://example.com/image1.jpg",
            "https://example.com/image2.jpg"
          ],
          "nullable": true
        }
      },
      "required": [
        "review_type",
        "email",
        "author",
        "content"
      ]
    },
    "relationships": {
      "type": "object",
      "properties": {
        "order": {
          "type": "object",
          "properties": {
            "data": {
              "type": "object",
              "properties": {
                "type": {
                  "$ref": "#/components/schemas/OrderEnum"
                },
                "id": {
                  "description": "The Order ID related to the review",
                  "type": "string",
                  "example": "42439497119686"
                }
              },
              "required": [
                "type",
                "id"
              ]
            }
          }
        }
      }
    }
  },
  "required": [
    "type",
    "attributes"
  ]
}