Magidoc

createForm
Mutation

Creates a configured form that can create actions or projects or send email according to its targets. Match input elements to the data they collect. Resolve project IDs first; top-level projectId and actionsData.projectId must be 17-character alphanumeric IDs. The newProject sentinel is valid only when target includes action and project. Each creationConditions entry requires fieldId, comparisonOperator, and value. The number field type is unsupported. panel and paneldynamic containers require non-empty nested field arrays.

Arguments

#

_id

String

Unique identifier for the form, optional one.

workspace

String !
Non-null

The workspace ID this form belongs to.

isDraft

Boolean

Whether the form is a draft. Defaults to false.

title

String !
Non-null

The form title that will be displayed to users

externalTitle

String

Optional external title for the form when shared externally

externalLogo

String

Optional external logo URL for the form when shared externally

target

[FormTarget !]!
Non-null

Array of form targets that determine what happens on form submission. Must be one or more of: action, project, mapToProject, email, emailToSubmitter

description

String

Optional form description

confirmMessage

String

Optional confirmation message shown after form submission

projectId

String

Optional project ID this form is associated with

parentActionId

String

Optional parent action ID for creating sub-actions

template

String

Optional template ID to use for created actions

projectTemplate

String

Optional project template ID to use for created projects

projectIsDraftMode

Boolean

Whether to create projects in draft mode. Defaults to false

assignees

[String !]

Array of user IDs to assign to created actions. Defaults to ['none']

projectOwner

String

Optional project owner user ID

members

[String !]!
Non-null

Array of member user IDs who can access this form. For AI Assistant: Include the current user's ID in this array if not provided.

teams = []

[String !]

Array of team IDs who can access this form. Defaults to []

sharingType

String !
Non-null

Form sharing type ('me', 'custom', 'everyone').

  • 'me': Only creator can access
  • 'custom': Specified members/teams can access
  • 'everyone': All workspace members can access

jsonFormData

FormJSONDataInput !
Non-null

Form configuration and content data

setFormNameToTitle = true

Boolean

Whether to include form name in generated titles. Defaults to true

setDateAndUserNameToTitle = true

Boolean

Whether to include date and username in generated titles. Defaults to true

setCardNumberToTitle = true

Boolean

Whether to include card number in generated titles. Defaults to true

setTemplateNameToTitle

Boolean

Whether to include template name in generated titles. Defaults to false

authRequired

Boolean

Whether authentication is required to submit the form. Defaults to false

allowProgressionTracking

Boolean

Whether to allow tracking form submission progress. Defaults to false

allowAccessToWhitelistedDomains

Boolean

Whether to restrict form access to specific email domains. Defaults to false

allowedEmailDomains

[String !]

Array of allowed email domains when domain restriction is enabled

onlyCreatorEditable

Boolean

Whether only the form creator can edit it. Defaults to false

mapToProjectId

String

Optional project ID to map form data to

actionsData

[ActionDataInput !]

Array of action data configurations

receivers

String

Optional email receivers when form target includes 'email'

emailDynamicFields

[String !]

Array of dynamic field names to include in email

archived

Boolean

Whether the form is archived. Defaults to false

shortcuttedAt

Date

Optional date when the form was shortcutted

draftFormId

String

Optional ID of the draft version of this form

publishedFormId

String

Optional ID of the published version of this form

Response

#

Returns Form !.

Example

#