Skip to main content
POST
/
api
/
pixels
curl -X POST https://api.linquid.io/api/pixels \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "campaignId": "campaign_123",
    "name": "Checkout Pixel",
    "pixelCode": "checkout_pixel",
    "conversionTracking": true
  }'

​
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
curl -X POST https://api.linquid.io/api/pixels \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "campaignId": "campaign_123",
    "name": "Checkout Pixel",
    "pixelCode": "checkout_pixel",
    "conversionTracking": true
  }'

​
Common Errors

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