---
title: "Retargeting Pixels API Reference"
description: "Fire your ad platforms' retargeting pixels (Meta, Google, TikTok, LinkedIn, Google Tag Manager) when someone visits one of your links or scans one of your QR codes, so you can retarget them later."
canonical: "https://linkbreakers.com/help/api/retargeting-pixels"
---

# Retargeting Pixels

Fire your ad platforms' retargeting pixels (Meta, Google, TikTok, LinkedIn, Google Tag Manager) when someone visits one of your links or scans one of your QR codes, so you can retarget them later.

## Retargeting Pixels

## [#](#retargeting-pixels-object)The RetargetingPixels object

The ad platform pixels a workspace fires on every visit to its links.

googleTagId

string

Google tag ID: a Google Analytics 4 measurement ID ("G-XXXXXXX") or a Google Ads tag ("AW-123456789").

gtmContainerId

string

Google Tag Manager container ID ("GTM-XXXXXXX"), to fire anything else set up in that container.

linkedinPartnerId

string

LinkedIn Insight Tag partner ID, digits only, e.g. "1234567".

metaPixelId

string

Meta (Facebook, Instagram) Pixel ID, digits only, e.g. "123456789012345".

tiktokPixelId

string

TikTok pixel ID, e.g. "C4ABCDEFGHIJKLMNOPQR".

updatedAt

string (date-time)

When the pixels were last changed. Absent when none were ever set.

Example object

```json
{
  "googleTagId": "string",
  "gtmContainerId": "string",
  "linkedinPartnerId": "string",
  "metaPixelId": "string",
  "tiktokPixelId": "string",
  "updatedAt": "2026-10-30T13:53:16.847Z"
}
```

GET

`/v1/retargeting-pixels`

Requires auth

## [#](#get-retargeting-pixels)Get retargeting pixels

Return the ad platform pixels the workspace fires on every visit to its links. Requires the \`integrations:read\` scope.

### [#](#get-retargeting-pixels-parameters)Parameters

This endpoint does not accept any parameters.

### [#](#get-retargeting-pixels-response)Response

200

Everything worked as expected.

pixels

object

The ad platform pixels a workspace fires on every visit to its links.

### [#](#get-retargeting-pixels-error)Error response

400-599

All endpoints may return an unexpected error payload when a request cannot be processed.

error

object

Required

Wrapped error response.

Example request (cURL)

```bash
curl -X GET "https://api.linkbreakers.com/v1/retargeting-pixels" \
  -H "Authorization: Bearer YOUR_TOKEN"
```

Typical response

```json
{
  "pixels": {
    "googleTagId": "string",
    "gtmContainerId": "string",
    "linkedinPartnerId": "string",
    "metaPixelId": "string",
    "tiktokPixelId": "string",
    "updatedAt": "2026-10-30T13:53:16.846Z"
  }
}
```

Base URL: `https://api.linkbreakers.com`

PUT

`/v1/retargeting-pixels`

Requires auth

## [#](#update-retargeting-pixels)Update retargeting pixels

Set, change or remove the ad platform pixels fired on every link visit. Omitted fields keep their value and an empty string removes a pixel. Once any pixel is set, link visits go through a short browser page that fires the pixels and then redirects, which adds a short delay. Requires the \`integrations:write\` scope.

### [#](#update-retargeting-pixels-parameters)Parameters

#### header parameters

Idempotency-Key

string

header

Makes retrying this request safe. See components.parameters.IdempotencyKey.

### [#](#update-retargeting-pixels-request)Request body

googleTagId

string

Google tag ID: "G-..." (Google Analytics 4) or "AW-..." (Google Ads).

gtmContainerId

string

Google Tag Manager container ID, "GTM-...".

linkedinPartnerId

string

LinkedIn Insight Tag partner ID, digits only.

metaPixelId

string

Meta (Facebook, Instagram) Pixel ID, digits only.

tiktokPixelId

string

TikTok pixel ID.

### [#](#update-retargeting-pixels-response)Response

200

Everything worked as expected.

pixels

object

The ad platform pixels a workspace fires on every visit to its links.

### [#](#update-retargeting-pixels-error)Error response

400-599

All endpoints may return an unexpected error payload when a request cannot be processed.

error

object

Required

Wrapped error response.

Example request (cURL)

```bash
curl -X PUT "https://api.linkbreakers.com/v1/retargeting-pixels" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Idempotency-Key: string" \
  -H "Content-Type: application/json" \
  --data '{"googleTagId":"string","gtmContainerId":"string","linkedinPartnerId":"string","metaPixelId":"string","tiktokPixelId":"string"}'
```

Sample payload (application/json)

```json
{
  "googleTagId": "string",
  "gtmContainerId": "string",
  "linkedinPartnerId": "string",
  "metaPixelId": "string",
  "tiktokPixelId": "string"
}
```

Typical response

```json
{
  "pixels": {
    "googleTagId": "string",
    "gtmContainerId": "string",
    "linkedinPartnerId": "string",
    "metaPixelId": "string",
    "tiktokPixelId": "string",
    "updatedAt": "2026-10-30T13:53:16.847Z"
  }
}
```

Base URL: `https://api.linkbreakers.com`

Cookies

We use cookies to measure our ads with Meta and Google and to record visits with PostHog. Our own analytics are cookie-free and run either way. [Privacy statement](https://linkbreakers.com/privacy#cookies)

---

Source: https://linkbreakers.com/help/api/retargeting-pixels