> ## Documentation Index
> Fetch the complete documentation index at: https://docs.trygravity.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Pixels

> Create and list the conversion pixels of your account.

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](https://docs.trygravity.com/advertisers/server-conversions.md).

## 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`.

**url** `string` *required*

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

**name** `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`.

```bash Request theme={null}
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"
  }'
```

```json Response 201 theme={null}
{
  "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.

```bash Request theme={null}
curl https://platform.trygravity.com/advertiser-dashboard/pixels \
  -H "X-API-Key: YOUR_API_KEY"
```

```json Response theme={null}
[
  {
    "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"
  }
]
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.