---
title: "Create Site Snippet"
method: POST
path: "/api/admin/site-snippets"
tags: ["admin"]
---

# Create Site Snippet

`POST /api/admin/site-snippets`

## Request

- Base URL: `https://store.hypergpt.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://store.hypergpt.ai/api/admin/site-snippets`
- Auth: HTTP bearer

Create a snippet. Validator runs first — errors block; warnings
block UNLESS ``?force=true`` is passed (UI surfaces warnings, operator
can opt-in).

## Query parameters

- `force` boolean

## Cookies

- `access_token` string, nullable

## Request body

- SnippetPayloadIn
  - `name` string, required
  - `provider` string, required
  - `payload` object
  - `position` string, required
  - `scope_kind` string
  - `scope_routes` string[]
  - `consent_category` string
  - `enabled` boolean
  - `order_index` integer
  - `notes` string

## Response `201`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

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