---
title: "Create watches"
method: POST
path: "/api/v1/watch"
tags: ["Monitoring"]
---

# Create watches

`POST /api/v1/watch`

## Request

- Base URL: `https://namesniper.pro`
- URL: `https://namesniper.pro/api/v1/watch`
- Auth: HTTP bearer

Start monitoring a handle across one or more platforms. Instagram, TikTok, and X require Pro or Business.

## Request body

- object
  - `username` string, required
  - `platforms` PlatformName[], required

## Response `200`

Created watches (duplicates are skipped).

- object
  - `success` unknown
  - `data` object
    - `created` Watch[]
      - `id` string, required
      - `username` string, required
      - `platform` 'youtube' | 'tiktok' | 'instagram' | 'twitter' | 'github' | 'npm' | 'twitch' | 'threads' | 'bluesky' | 'pinterest' | 'snapchat' | 'kick' | 'linktree' | 'roblox' | 'telegram', required
      - `status` string, required: Current watch state, e.g. watching or paused.
      - `lastStatus` string, nullable: Last observed availability status.
      - `lastCheckedAt` string, date-time, nullable
      - `lastChangedAt` string, date-time, nullable
      - `checkCount` integer
      - `createdAt` string, date-time, required
    - `skipped` PlatformName[]
  - `meta` object
    - `slots` Slots
      - `used` integer
      - `limit` integer

## Other responses

- `400`: Invalid request (missing field, bad JSON, or invalid value).
- `401`: Missing or invalid API key.
- `403`: Authenticated but not permitted (revoked key or a feature your plan does not include).

---

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