---
title: "Add a traffic source (campaign) to a tracker"
method: POST
path: "/api/v1/tracker/{tracker_id}/campaigns"
tags: ["Tracker (Stream)"]
---

# Add a traffic source (campaign) to a tracker

`POST /api/v1/tracker/{tracker_id}/campaigns`

Registers a new traffic source (e.g. a new FB ad campaign) pointing at this tracker. Defaults to MODERATION status. Use the returned id as the campaignId query param on the tracker link for that new campaign's destination URL.

## Path parameters

- `tracker_id` string, uuid, required

## Request body

- TrackerCampaignCreateDTO
  - `name` string, nullable — Optional ops-facing label for this traffic source
  - `status` 'ACTIVE' | 'MODERATION'

## Response `201`

Successful Response

- TrackerCampaignResponse
  - `id` string, uuid, required — Use this value as the campaignId query param on the tracker link
  - `trackerId` string, uuid, required
  - `name` string, nullable
  - `status` 'ACTIVE' | 'MODERATION', required
  - `createdAt` string, date-time, required
  - `sources` TrackerCampaignSourceResponse[] — External ad-platform identifiers mapped to this traffic source.
    - `id` string, uuid, required
    - `campaignId` string, uuid, required
    - `sourceId` string, required
    - `createdAt` string, date-time, required

## Other responses

- `401` — Authentication required.
- `403` — Access denied.
- `404` — The requested resource was not found.
- `422` — Validation Error

---

[API](https://skmtc.dev/pwapps/apis/curie-api.md) · [All operations](https://skmtc.dev/pwapps/apis/curie-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/pwapps/curie-api/revisions/b0af9064dfef/schema)