Pixels

Use these endpoints to create a conversion pixel for a site and to list your pixels. To send conversions from your backend, use the Conversions API.

POST `/advertiser-dashboard/pixels`

Create a conversion pixel for a site. After Gravity creates the pixel, it checks the pixel installation in the background. The response is 201.

string

required

The URL of the site for the pixel. If the URL has no scheme, Gravity adds https://.

string

The display name of the pixel. The default is Untitled Pixel.

is_functional starts as null. After the background check, it changes to true or false. The value stays null if Gravity cannot do the check, for example on a private URL. If a pixel for the URL already exists, the response is 409. If the URL is not valid, the response is 422.

Request

curl -X POST https://platform.trygravity.com/advertiser-dashboard/pixels \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://acme.com",
    "name": "Acme main site"
  }'

Response 201

{
  "pixel_id": "pix-123",
  "url": "https://acme.com",
  "name": "Acme main site",
  "is_active": true,
  "is_functional": null,
  "account_id": "acct-789",
  "created_at": "2026-07-01T12:00:00"
}

GET `/advertiser-dashboard/pixels`

List all the pixels of your account, newest first.

Request

curl https://platform.trygravity.com/advertiser-dashboard/pixels \
  -H "X-API-Key: YOUR_API_KEY"

Response

[
  {
    "pixel_id": "pix-123",
    "url": "https://acme.com",
    "name": "Acme main site",
    "is_active": true,
    "is_functional": true,
    "account_id": "acct-789",
    "created_at": "2026-07-01T12:00:00"
  }
]

Get started

Advertisers

Publishers

API reference

Resources

POST `/advertiser-dashboard/pixels`

GET `/advertiser-dashboard/pixels`

​POST /advertiser-dashboard/pixels

​GET /advertiser-dashboard/pixels

POST `/advertiser-dashboard/pixels`

GET `/advertiser-dashboard/pixels`