Forms

Create a form

Creates a form, optionally with all its nodes in one request.

post/forms

Request

  • Base URL: https://api.clipform.io/v1
  • URL: https://api.clipform.io/v1/forms
  • Auth: HTTP bearer

Request body

titlestring required

Form title

workspace_idstring uuid required

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

is_liveboolean

Whether the form is immediately live (online for respondents). Defaults to true so created forms are shareable right away - pass false explicitly to create offline.

first_runboolean

Internal first-run flag. Set by the dashboard cold-start gate when it auto-scaffolds a new user's starter form, to suppress the first_form_created activation milestone - the scaffold is not authoring. Leave unset for normal creates.

Response

Form created

form_idstring uuid
share_idstring
form_urlstring uri nullable

Null for a normal authenticated create. For an anonymous caller in the shared public-company workspace (web/bot/email channels), a save/claim link to move the form into a real account. For an MCP-minted anonymous session's first form (#3330), a one-time same-UID claim URL instead - null on any later create reusing that same session.

viewer_urlstring uri

A live public URL for an authenticated/claimed workspace. For an MCP-minted anonymous session (#3330), a time-limited ?mode=preview&pt=... link only the caller can open - never public until the account is claimed and the form is published.

Changes

No recorded changes to this operation across all 1 revision of this API.