---
title: "Create Placement"
method: POST
path: "/v1/advertising/placements"
tags: ["advertising"]
---

# Create Placement

`POST /v1/advertising/placements`

## Request

- Base URL: `https://api.shortkit.dev` (the document declares no server; this is the origin it was published from)
- URL: `https://api.shortkit.dev/v1/advertising/placements`
- Auth: none declared

## Headers

- `idempotency-key` string, nullable

## Request body

- PlacementCreate
  - `placementKey` string, required
  - `enabled` boolean
  - `mode` 'fixed' | 'adaptive'
  - `firstAfter` integer
  - `every` integer
  - `minGap` integer
  - `maxGap` integer
  - `sources` PlacementSourcePin[]
    - `sourceId` string, uuid, required
    - `sourceRevision` integer, required

## Response `201`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

## Changes

- **2026-10-26** `915ff7e82b20`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/shortkit/apis/shortkit-api/changes/v1/advertising/placements/post.md)

---

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