---
title: "Create or bulk-create tracked prompts"
method: POST
path: "/v3/ai-tracker/prompts"
tags: ["AI Tracker"]
---

# Create or bulk-create tracked prompts

`POST /v3/ai-tracker/prompts`

Track AI-visibility prompts. CONSUMES CREDITS (each prompt is run against the AI platforms): always ask the user for permission before calling this. Single mode: creates one prompt and returns its record. Bulk mode: pass `items` array to create multiple at once.

## Request body

- union
  - object
    - `teamId` string
    - `prompt` string, required — Single prompt text
    - `isEnabled` boolean
    - `isBranded` boolean
    - `region` object, nullable — Optional region targeting
    - `items` object[] — Bulk prompt items
      - `prompt` string, required
      - `isEnabled` boolean
      - `isBranded` boolean
    - `enqueue` boolean — When false, create or enable the prompt without immediately running it.
  - object
    - `teamId` string
    - `prompt` string — Single prompt text
    - `isEnabled` boolean
    - `isBranded` boolean
    - `region` object, nullable — Optional region targeting
    - `items` object[], required — Bulk prompt items
      - `prompt` string, required
      - `isEnabled` boolean
      - `isBranded` boolean
    - `enqueue` boolean — When false, create or enable the prompt without immediately running it.

## Other responses

- `400` — Default Response
- `500` — Default Response

---

[API](https://skmtc.net/snowseo/apis/snowseo-api.md) · [All operations](https://skmtc.net/snowseo/apis/snowseo-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/snowseo/snowseo-api/versions/aa8eaa9e34a0/schema)