create_form
Generate Tally forms with predefined fields and configurations. Convert simple field definitions into Tally's blocks-based structure automatically, with optional status defaulting to DRAFT. Ideal for creating structured forms quickly.
Instructions
Create a new Tally form with specified fields and configuration. This tool converts simple field definitions into Tally's complex blocks-based structure automatically. The status field is optional and defaults to DRAFT if not specified.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| description | No | Optional form description - displayed below the title to provide context | |
| fields | Yes | Array of form fields/questions. Each field will be converted to appropriate Tally blocks automatically. | |
| status | No | Form publication status. Use DRAFT for unpublished forms that are being worked on, or PUBLISHED for live forms. Defaults to DRAFT if not specified. | DRAFT |
| title | Yes | Form title (required) - will be displayed as the main form heading |
Input Schema (JSON Schema)
{
"additionalProperties": false,
"examples": [
{
"description": "Help us improve our service",
"fields": [
{
"label": "What is your name?",
"required": true,
"type": "text"
},
{
"label": "Email address",
"required": true,
"type": "email"
},
{
"label": "How would you rate our service?",
"options": [
"Excellent",
"Good",
"Fair",
"Poor"
],
"required": false,
"type": "select"
}
],
"status": "DRAFT",
"title": "Customer Feedback Survey"
}
],
"properties": {
"description": {
"description": "Optional form description - displayed below the title to provide context",
"type": "string"
},
"fields": {
"description": "Array of form fields/questions. Each field will be converted to appropriate Tally blocks automatically.",
"items": {
"additionalProperties": false,
"properties": {
"label": {
"description": "Field label/question text - what the user will see",
"minLength": 1,
"type": "string"
},
"options": {
"description": "Available options for select, checkbox, or radio field types. Required for select/checkbox/radio fields.",
"items": {
"type": "string"
},
"type": "array"
},
"required": {
"default": false,
"description": "Whether this field must be filled out before form submission",
"type": "boolean"
},
"type": {
"description": "Field input type. Maps to Tally blocks: text→INPUT_TEXT, email→INPUT_EMAIL, number→INPUT_NUMBER, textarea→TEXTAREA, select→DROPDOWN, checkbox→CHECKBOXES, radio→MULTIPLE_CHOICE",
"enum": [
"text",
"email",
"number",
"textarea",
"select",
"checkbox",
"radio"
],
"type": "string"
}
},
"required": [
"type",
"label"
],
"type": "object"
},
"minItems": 1,
"type": "array"
},
"status": {
"default": "DRAFT",
"description": "Form publication status. Use DRAFT for unpublished forms that are being worked on, or PUBLISHED for live forms. Defaults to DRAFT if not specified.",
"enum": [
"DRAFT",
"PUBLISHED"
],
"type": "string"
},
"title": {
"description": "Form title (required) - will be displayed as the main form heading",
"maxLength": 100,
"minLength": 1,
"type": "string"
}
},
"required": [
"title",
"fields"
],
"type": "object"
}