---
title: "Create a custom tracking"
method: POST
path: "/content-tracking/v1/trackings"
tags: ["Content Tracking"]
---

# Create a custom tracking

`POST /content-tracking/v1/trackings`

## Request

- Base URL: `https://api.influencity.com`
- URL: `https://api.influencity.com/content-tracking/v1/trackings`
- Auth: HTTP bearer

Creates a custom content tracking for the authenticated brand.

## Request body

- ContentTrackingCreateTrackingRequest
  - `name` string, required: Tracking display name (unique per brand).
  - `description` string: Optional tracking description. Not returned in the public 201 body.
  - `hashtags` string[]: Hashtag filters (max 5). Omit or pass [].
  - `mentions` string[]: Mention filters (max 5). Omit or pass [].
  - `keywords` string[]: Keyword filters (max 5). Omit or pass [].
  - `profileIds` string[]: Optional profile ObjectIds to attach. Alone is not enough; content filters are required.
  - `startDate` string, required: Tracking start date (YYYY-MM-DD). Required. Must not be in the past (UTC). If it is today UTC, the tracking starts immediately.
  - `endDate` string, required: Tracking end date (YYYY-MM-DD). Required; must be >= startDate.

## Response `201`

Custom tracking created.

- ContentTrackingCreateTrackingResponse
  - `trackingId` string, required: Created tracking identifier.
  - `name` string, required: Tracking display name.
  - `status` string, required: Tracking status.
  - `startDate` string, required: Normalized start date. Today UTC is returned as the instant the tracking started.
  - `endDate` string, required: Normalized end date.
  - `createdFrom` string, required: Origin of the tracking. Public API creates always report `api`.

## Other responses

- `400`: Invalid request payload or validation failed.
- `401`: Missing or invalid API token.
- `403`: The requested capability is not enabled for this brand plan.
- `409`: A tracking with this name already exists.
- `422`: A business rule was violated (for example the brand profile limit was exceeded).
- `429`: Request rate exceeded (short-term throttle) or daily organization quota exhausted. `error.code` is `RATE_LIMIT_EXCEEDED` for throttling (may include `Retry-After`) or `QUOTA_EXCEEDED` when the daily quota is used up.
- `502`: The API could not complete the request.
- `503`: Service temporarily unavailable.
- `504`: The request timed out.

---

[API](https://skmtc.dev/influencity/apis/influencity-api.md) - [All operations](https://skmtc.dev/influencity/apis/influencity-api/llms.txt) - [OpenAPI document](https://skmtc.dev/influencity/apis/influencity-api/revisions/827263990edf?raw)