Skip to main content
POST

Request Body

campaignId
string
required
Campaign ID. Pixels are campaign-scoped.
name
string
required
Pixel display name
pixelCode
string
required
Global unique code, 3..50 chars, letters/numbers/-/_
description
string
Optional description
eventName
string
Optional event label
captureParams
array
Optional query parameters to capture
conversionTracking
boolean
Enable conversion tracking for this pixel
enabled
boolean
default:"true"
Initial enabled state
expiresAt
string
Optional ISO datetime expiry
firesLimit
number
Optional positive cap for total fires

Access and gates

  • Permission: pixels:create
  • Feature gate: pixelSdk

Common Errors

  • 404: campaign not found or inaccessible
  • 409: duplicate pixelCode
  • 403: feature or permission denied