Macro is a unified workspace for teams: email, chat, docs, tasks, agents, calls, and CRM — @-linked together with shared AI memory.
TypeScript agentaiai-agentsall-in-onecrmcrm-systememaillinearmcpmessagingnotesnotionofficerustslackslack-alternativestartupstartup-toolstypescriptworkspace
---
title: CreateForm
description: >-
Create a complete questionnaire with response columns, ordered sections, gates
and an optional saved booking link.
---
# CreateForm
Create a complete questionnaire with response columns, ordered sections, gates and an optional saved booking link. Creates closed and private; use SetFormAccess afterward to open or share it. Existing-table attachment requires database Owner and an unbound table. Use local question/option keys in gates and reference only earlier sections. Required questions require an answer; gates compare answers using AND/OR. A questions section may set showWhen (rules like a gate's, referencing only questions of earlier sections) to branch: when earlier answers fail them the section is skipped, its questions are not required and their answers are not saved. Empty answers pass only IsEmpty. A final booking step reveals an existing authorized link after acceptance; its independent URL remains usable, and strict qualification is unsupported. Each invocation creates a new form; after a timeout, use ListForms and ReadForm before trying again. Returns actual saved IDs, links and completion state; inspect partial work instead of recreating.
## Parameters
| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `name` | string | Yes | Form name, also the new database name for source/new. |
| `source` | FormSource | Yes | Where a new form's responses go. |
| `draft` | Draft | Yes | Complete ordered draft. Extra backing columns need not be questions. |