Skip to main content
POST
/
pixels
Create Pixel
curl --request POST \
  --url https://api.audiencelab.io/pixels \
  --header 'Content-Type: application/json' \
  --header 'X-Api-Key: <api-key>' \
  --data '
{
  "websiteName": "Test Site",
  "websiteUrl": "https://test.com",
  "webhookUrl": "https://hooks.example.com/pixel",
  "version": "v4"
}
'
{
  "pixel_id": "912b78c3-83e6-4d6a-8245-def0dde26224",
  "install_url": "https://pixel.example/install/abcd1234"
}

Authorizations

​
X-Api-Key
string
header
required

Body

application/json
​
websiteName
string
required

The display name for the pixel (site name)

​
websiteUrl
string
required

The URL where the pixel will be installed

​
webhookUrl
string | null

Optional webhook URL for pixel events

​
version
enum<string>
default:v3

Pixel provider version. Defaults to "v3" if not specified.

Available options:
v3,
v4

Response

Pixel created successfully

​
pixel_id
string
Example:

"912b78c3-83e6-4d6a-8245-def0dde26224"

​
install_url
string
Example:

"https://pixel.example/install/abcd1234"