---
title: "New site key bound to your sites (1–20 origins; daily_cap 1–100000, default 500)"
method: POST
path: "/api/v1/embed/keys"
tags: ["Embed"]
---

# New site key bound to your sites (1–20 origins; daily_cap 1–100000, default 500)

`POST /api/v1/embed/keys`

## Request

- Base URL: `https://philforms.com`
- URL: `https://philforms.com/api/v1/embed/keys`
- Auth: HTTP bearer

## Request body

- object
  - `name` string
  - `origin` string[], required
  - `form` string[]: Forms it may open (omit: every form)
  - `webhook_url` string
  - `daily_cap` integer
  - `is_reading_allowed` boolean: Let visitors scan/read documents (billed to you)

## Response `201`

{ key }

## Other responses

- `400`: Bad origin, form list, cap or webhook
- `402`: Plan has no site keys left — upgrade

---

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