---
title: "Create a product after the human has explicitly delegated setup authority"
method: POST
path: "/api/agent/v1/products"
---

# Create a product after the human has explicitly delegated setup authority

`POST /api/agent/v1/products`

## Request

- Base URL: `https://analytics.davisvillelabs.com`
- URL: `https://analytics.davisvillelabs.com/api/agent/v1/products`
- Auth: HTTP bearer

Requires products:create scope and an Idempotency-Key. Returns the ingestion credential only on the original successful response.

## Headers

- `Idempotency-Key` string, required

## Request body

- object
  - `product_name` string, required
  - `product_url` string, uri
  - `time_zone` string

## Response `200`

Idempotent replay; credential is not re-exposed

## Other responses

- `201`: Product created; one-time ingestion credential returned
- `401`: Missing, expired, or revoked delegated token
- `403`: Token lacks products:create scope
- `409`: Product limit reached or idempotency conflict

---

[API](https://skmtc.dev/davisvillelabs/apis/ai-agent-analytics-agent-interface.md) · [All operations](https://skmtc.dev/davisvillelabs/apis/ai-agent-analytics-agent-interface/llms.txt) · [OpenAPI document](https://skmtc.dev/davisvillelabs/apis/ai-agent-analytics-agent-interface/revisions/d7f39c451615?raw)