API reference

CreateForm

Create a form; body carries title, surfaces and view type. Invalid input returns userErrors. Write access, forms toolset, MCP tool create_form.

Access: Write

Variables

Variable	Type	Required	Accepts	Description
`input`	`CreateFormInput!`	yes	Input object, below

Input types

CreateFormInput

Field	Type	Required	Accepts	Description
`body`	`JSON!`	yes	Object, fields below

`CreateFormInput.body`

Field	Type	Required	Accepts
`title`	string	no	1 to 200 characters
`surfaces`	list of string	no	One of `IN_PLATFORM`, `WEBSITE`, `EMAIL_SHAREABLE`
`priority`	integer	no	0 to 9999

Call it

bash

curl https://api.missin.co.uk/graphql/v1 \
  -H "Authorization: Bearer $MISSIN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"operationName":"CreateForm","variables":{"input":{"body":{"title":"…"}}},"extensions":{"persistedQuery":{"version":1,"sha256Hash":"9bc46e214e9c00e0e1b5aaa0ae1a9d3a5e43e47fc701866a698705c650bcb647"}}}'

Document

graphql

mutation CreateForm($input: CreateFormInput!) { __typename createForm(input: $input) { __typename formId formSlug userErrors { __typename code field message } } }