---
title: "Activate storefront pixel"
method: POST
path: "/integrations/{id}/pixel"
tags: ["Integrations"]
---

# Activate storefront pixel

`POST /integrations/{id}/pixel`

Installs the Shopify storefront tracking pixel, or repoints an existing one at this account. Idempotent - an already-live pixel returns changed false without writing to the store. Events start arriving on the next storefront visit; nothing is backfilled. Fails with a 400 naming the reconnect step when the store granted an older permission set. Shopify only. Requires the integrations:manage scope.

## Path parameters

- `id` string, required

## Response `200`

Pixel installed, repointed, or already live

- object — Live storefront tracking pixel state for a Shopify integration, read from the store on every call.
  - `success` boolean
  - `integrationId` string
  - `provider` string
  - `shopDomain` string
  - `pixel` object
    - `installed` boolean — Whether a pixel for this app exists on the store.
    - `id` string, nullable — Shopify's pixel ID.
    - `endpoint` string, nullable — Callback URL the installed pixel posts events to.
    - `endpointCurrent` boolean — Whether the pixel posts to this account's canonical endpoint or the supported Shopify compatibility endpoint.
    - `configurationCurrent` boolean — Whether the endpoint and signed company, shop, and integration settings all match the current connection.
    - `healthy` boolean — Installed, current, and confirmed by Shopify. Check this before relying on any on-site event.
    - `error` string, nullable — Set when Shopify could not be reached or refused the query. Distinct from "not installed" - the state is unknown.
  - `dependentEvents` string[] — Event names that depend on this pixel. They are confirmed unable to arrive only when pixel.error is null and pixel.healthy is false.
  - `message` string
  - `changed` boolean — False when the pixel was already installed and current.
  - `created` boolean — True when a new pixel was installed.
  - `updated` boolean — True when an existing pixel was repointed.

## Other responses

- `400` — Provider has no storefront pixel, the integration is disconnected, or Shopify refused the install
- `401` — Unauthorized
- `404` — Integration not found

---

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