---
title: "Instantly provision a live form endpoint (no auth — built for AI agents)"
method: POST
path: "/api/v1/instant"
---

# Instantly provision a live form endpoint (no auth — built for AI agents)

`POST /api/v1/instant`

## Request

- Base URL: `https://formslist.com`
- URL: `https://formslist.com/api/v1/instant`
- Auth: none declared

Creates a shadow account + form in one call AND returns a scoped API key, so an agent can immediately read submissions and manage the form with no human step. The endpoint works immediately; the site owner receives a claim email. Unclaimed forms expire after 7 days. Limits: 5/IP/day, 3/email/day.

## Request body

- object
  - `email` string, email, required: The SITE OWNER's real email — claim link + notifications go here
  - `form_name` string

## Response `201`

Form provisioned

- object
  - `form_id` string
  - `endpoint` string
  - `method` string
  - `html_snippet` string
  - `curl_example` string
  - `claim_url` string
  - `expires_at` string
  - `api_key` string: Bearer key scoped to the workspace just created — use it against /api/v1/* to read submissions and manage the form without a human. Expires in 30 days.
  - `next_steps` string[]
  - `docs_url` string
  - `note` string

## Other responses

- `400`: Invalid input
- `409`: Email already has a claimed account — use the authenticated API instead
- `429`: Rate limited

---

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