Create a form draft

Creates a draft form in an authorized workspace. OAuth connections can select a granted workspace; API keys remain bound to one workspace. Provide a builder-compatible draftSchema for full control.

post/forms

Request

  • Base URL: https://app.formasty.com/api/v1
  • URL: https://app.formasty.com/api/v1/forms
  • Auth: one of:
    • OAuth 2 (authorization code, authorization URL https://app.formasty.com/oauth/authorize/api/v1, token URL https://app.formasty.com/oauth/token)
    • HTTP bearer

Headers

X-Formasty-Workspace-Idstring

Alternative target workspace selector. It must match workspaceId in the request body when both are provided.

Request body

workspaceIdstring
titlestring

Response

Created form.

settingsobject required

Complete operational settings for the current draft. Send this snapshot with draft_schema when changing both.

draft_revisioninteger
public_urlstring

Changes

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