Clipform

Create a new form

Creates a bare form scaffold with a start node and end screen in the specified workspace. `workspace_id` is required - obtain it from GET /v1/me. Authenticated callers (OAuth or API key) own the form via their workspace. Anonymous callers receive a `form_url` for later ownership transfer.

POST
/forms

Request Body

application/jsonRequired
title
Required
string

Form title

Maximum length: 200
workspace_id
Required
string

Target workspace for the new form. Obtain from GET /v1/me.

Format: "uuid"
is_liveboolean

Whether the form is immediately live

Default: false
curl -X POST "https://api.clipform.io/v1/forms" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "string",
    "workspace_id": "0967198e-ec7b-4c6b-b4d3-f71244cadbe9",
    "is_live": false
  }'

Form created

{
  "form_id": "46af4ef5-2c18-4098-9bc5-c048fb90b843",
  "share_id": "string",
  "form_url": "http://example.com",
  "viewer_url": "http://example.com"
}