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

# Send a SnackVideo Events API event

> Public storefront endpoint. Sends browser-collected conversion events through Scalev using the SnackVideo server pixels configured on the store's hosted storefront analytics setup. The store path selects the storefront; do not send a custom domain to identify the store. A `204` means the payload was accepted for asynchronous delivery.




## OpenAPI

````yaml https://api-openapi.scalev.com/specs/v3/openapi.json post /v3/stores/{store_id}/public/analytics/snackvideo/events
openapi: 3.0.3
info:
  title: Nexus Commerce API
  version: 3.0.0
  description: >
    Public v3 commerce contract for storefront, customer, and authenticated
    business

    commerce flows.


    This specification intentionally documents only the `/v3` namespace.

    Store-derived public storefront routes under
    `/v3/stores/{store_id}/public/*` require `X-Scalev-Storefront-Api-Key`.

    HTML Mode public page runtime routes under `/v3/pages/{page_unique_id}/*`
    require `X-Scalev-Page-Api-Key` and do not accept storefront public API
    keys.

    Storefront API requests made with `X-Scalev-Storefront-Api-Key`, page
    runtime requests made with `X-Scalev-Page-Api-Key`, and guest-cart requests
    made with `X-Scalev-Guest-Token` are browser client requests and use the
    direct client/IP rate limiter. Machine-authenticated business requests are
    rate-limited per API key or OAuth installation. Rate-limit metadata is
    returned in `X-Ratelimit-*` headers, and `429` responses may be plain text.
  license:
    name: Proprietary
servers:
  - url: https://api.scalev.com
    description: Production
security: []
tags:
  - name: Orders
    description: Authenticated business order management endpoints.
  - name: Storefront
    description: >-
      Public storefront catalog, guest cart, and guest checkout flows. All
      store-derived public storefront routes require
      `X-Scalev-Storefront-Api-Key`.
  - name: HTML Mode Pages
    description: >-
      Public HTML Mode runtime endpoints. These routes require
      `X-Scalev-Page-Api-Key` for the path page and reject storefront public API
      keys.
  - name: OAuth
    description: >-
      Public and machine OAuth token-management endpoints. The authorization
      code flow accepts the standard `scope` parameter; public OAuth clients may
      use PKCE with `token_endpoint_auth_method=none`, and metadata document
      clients may use `private_key_jwt`.
  - name: Identity
    description: Authenticated business identity context.
  - name: Business Users
    description: Authenticated business-user membership self-service endpoints.
  - name: Landing Pages
    description: >-
      Authenticated business landing page endpoints. The documented payloads
      focus on HTML Mode pages.
    externalDocs:
      description: >-
        Read the Landing Pages API guide before creating or publishing HTML Mode
        pages.
      url: https://docs.scalev.com/en/landing-pages-api
  - name: Analytics Setup
    description: >-
      Authenticated business analytics provider catalogs and pixel/container
      endpoints used when configuring landing page displays.
  - name: OAuth Billing
    description: OAuth billing runtime, refund, and developer finance endpoints.
  - name: Customer Auth
    description: Public customer authentication and password-reset endpoints.
  - name: Customer Account
    description: Authenticated customer profile endpoints.
  - name: Customer Cart
    description: Authenticated customer cart management endpoints.
  - name: Customer Checkout
    description: Authenticated customer checkout preparation and confirmation endpoints.
  - name: Customer Orders
    description: Authenticated customer order read endpoints.
  - name: Customer Subscriptions
    description: Authenticated customer subscription and subscription-item endpoints.
  - name: Customer Courses
    description: Authenticated customer digital course access and progress endpoints.
  - name: Discounts
    description: Discount-code validation and authenticated management endpoints.
  - name: Locations
    description: Authenticated business location lookup endpoints.
  - name: Business Stores
    description: >-
      Authenticated business store lookup endpoints. These routes use direct
      numeric Scalev store database IDs.
  - name: Storefront Setup
    description: >-
      Authenticated business setup endpoints for public storefront keys and CORS
      origins.
  - name: Shipping
    description: Authenticated business shipping lookup endpoints.
  - name: Business Products
    description: >-
      Authenticated business product, variant, taxonomy, and course management
      endpoints.
  - name: Business Bundles
    description: >-
      Authenticated business bundle, bundle-price-option, and related
      bundle-management endpoints.
  - name: Business Customers
    description: Authenticated business customer and customer-address management endpoints.
  - name: WABA
    description: >-
      Authenticated WhatsApp Business Account operations and related WABA
      resources.
  - name: WhatsApp Integrations
    description: Authenticated WhatsApp integration management endpoints.
paths:
  /v3/stores/{store_id}/public/analytics/snackvideo/events:
    parameters:
      - $ref: '#/components/parameters/StoreId'
      - $ref: '#/components/parameters/StorefrontPublicApiKey'
    post:
      tags:
        - Storefront
      summary: Send a SnackVideo Events API event
      description: >
        Public storefront endpoint. Sends browser-collected conversion events
        through Scalev using the SnackVideo server pixels configured on the
        store's hosted storefront analytics setup. The store path selects the
        storefront; do not send a custom domain to identify the store. A `204`
        means the payload was accepted for asynchronous delivery.
      operationId: sendStorefrontSnackVideoConversionEvent
      requestBody:
        $ref: >-
          #/components/requestBodies/StorefrontSnackVideoConversionEventRequestBody
      responses:
        '204':
          $ref: '#/components/responses/NoContentResponse'
        '400':
          $ref: '#/components/responses/BadRequestResponse'
        '404':
          $ref: '#/components/responses/NotFoundResponse'
components:
  parameters:
    StoreId:
      name: store_id
      in: path
      required: true
      schema:
        type: string
      description: Store `unique_id`.
    StorefrontPublicApiKey:
      name: X-Scalev-Storefront-Api-Key
      in: header
      required: true
      schema:
        type: string
      description: >-
        Publishable storefront public API key for the target store. Page public
        API keys are not accepted on Storefront public routes.
  requestBodies:
    StorefrontSnackVideoConversionEventRequestBody:
      required: true
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/StorefrontSnackVideoConversionEventRequest'
  responses:
    NoContentResponse:
      description: Success with no response body
    BadRequestResponse:
      description: Bad Request
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ApiErrorResponse'
    NotFoundResponse:
      description: Not Found
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ApiErrorResponse'
  schemas:
    StorefrontSnackVideoConversionEventRequest:
      type: object
      required:
        - click_id
        - events
      properties:
        click_id:
          type: string
          description: SnackVideo click ID.
        event_source_url:
          type: string
          format: uri
          nullable: true
          description: >-
            Optional full storefront page URL used to choose checkout versus
            home storefront analytics configuration.
        referrer_url:
          type: string
          format: uri
          nullable: true
          description: >-
            Optional browser referrer URL used to choose checkout versus home
            storefront analytics configuration.
        events:
          type: array
          minItems: 1
          items:
            $ref: '#/components/schemas/StorefrontSnackVideoConversionEvent'
        variants:
          type: array
          items:
            $ref: '#/components/schemas/StorefrontAnalyticsVariantItem'
        bundle_price_options:
          type: array
          items:
            $ref: '#/components/schemas/StorefrontAnalyticsBundlePriceOptionItem'
      additionalProperties: true
    ApiErrorResponse:
      type: object
      properties:
        error:
          $ref: '#/components/schemas/FlexibleValue'
        error_code:
          type: string
        message:
          type: string
          description: Error-only human-readable detail.
        errors:
          $ref: '#/components/schemas/FlexibleValue'
      additionalProperties: false
    StorefrontSnackVideoConversionEvent:
      type: object
      required:
        - event_name
      properties:
        event_name:
          type: string
          example: addToCart
        properties:
          $ref: '#/components/schemas/StorefrontSnackVideoConversionEventProperties'
      additionalProperties: false
    StorefrontAnalyticsVariantItem:
      type: object
      required:
        - variant_unique_id
        - quantity
      properties:
        variant_unique_id:
          type: string
          description: Variant unique ID from the storefront product payload.
        quantity:
          type: integer
          minimum: 1
      additionalProperties: false
    StorefrontAnalyticsBundlePriceOptionItem:
      type: object
      required:
        - bundle_price_option_unique_id
        - quantity
      properties:
        bundle_price_option_unique_id:
          type: string
          description: Bundle price option unique ID from the storefront bundle payload.
        quantity:
          type: integer
          minimum: 1
      additionalProperties: false
    FlexibleValue:
      oneOf:
        - $ref: '#/components/schemas/FlexibleObject'
        - type: array
          items: {}
        - type: string
        - type: number
        - type: boolean
    StorefrontSnackVideoConversionEventProperties:
      type: object
      properties:
        content_type:
          type: string
          nullable: true
        content_category:
          type: string
          nullable: true
        content_name:
          type: string
          nullable: true
        currency:
          type: string
          nullable: true
          example: IDR
        value:
          type: integer
          nullable: true
        quantity:
          type: integer
          nullable: true
        price:
          type: integer
          nullable: true
        query:
          type: string
          nullable: true
        mapping_id:
          type: string
          nullable: true
      additionalProperties: true
    FlexibleObject:
      type: object
      additionalProperties: true

````