---
title: "Receive Storefront Events"
method: POST
path: "/stores/{storeId}/storefront/events"
tags: ["Storefront"]
---

# Receive Storefront Events

`POST /stores/{storeId}/storefront/events`

Processes events from storefronts using Shopify pixel event schema Requires the [`storefront_events_write`](/docs/api-reference/scopes) scope.

## Path parameters

- `storeId` string, required

## Request body

- StorefrontEventSchema — Shopify pixel event for storefront tracking.
  - `anonymousId` string — Anonymous identifier for users without account.
  - `cart` object, nullable — Cart information.
  - `cartLine` object — Information about specific cart line item.
  - `checkout` object — Checkout information.
  - `collection` object — Collection information.
  - `customer` object, nullable — Customer information if available.
  - `customerEmail` string, email — Customer email if available.
  - `customerPhone` string — Customer phone if available.
  - `eventId` string, required — Unique identifier for the event.
  - `eventName` 'product_added_to_cart' | 'product_removed_from_cart' | 'product_viewed' | 'checkout_started' | 'checkout_completed' | 'checkout_contact_info_submitted' | 'page_viewed' | 'collection_viewed', required — Name of the Shopify pixel event.
  - `productVariant` object — Product variant information.
  - `source` 'AIMERCE', required — Source of the event.
  - `timestamp` string, date-time, required — ISO 8601 timestamp when the event occurred.
  - `urlWithParams` string — Complete page URL with query parameters.
  - `urlWithoutParams` string — Page URL without query parameters.

## Response `204`

Event processed successfully

## Other responses

- `400` — Invalid event payload
- `default` — Error

---

[API](https://skmtc.dev/redoapp/apis/redo-api.md) · [All operations](https://skmtc.dev/redoapp/apis/redo-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/redoapp/redo-api/revisions/119714540a45/schema)