API reference

CreateWaitlist

Create a waitlist and, when needed, its signup form. Write access, waitlists toolset, MCP tool create_waitlist.

Access: Write

Variables

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

Input types

CreateWaitlistInput

Field	Type	Required	Accepts	Description
`doubleOptIn`	`Boolean`	no
`formId`	`UUID`	no
`incentiveId`	`UUID`	no
`name`	`String!`	yes	1 to 120 characters
`notifyEmails`	`[String!]`	no	at most 5 items	Emailed a digest of new confirmed signups (at most one per 15 minutes). Empty or omitted = off.
`releasedMessage`	`String`	no	at most 280 characters
`retentionDays`	`Int`	no	32-bit integer. 30 to 730
`shopifyProductGid`	`String`	no	matches `^gid:\/\/shopify\/Product\/\d+$`

Call it

bash

curl https://api.missin.co.uk/graphql/v1 \
  -H "Authorization: Bearer $MISSIN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"operationName":"CreateWaitlist","variables":{"input":{"name":"Example"}},"extensions":{"persistedQuery":{"version":1,"sha256Hash":"8841ef6c474a61c579bf210ac94c2670dc6fd1b50147a85a28552b55311a38eb"}}}'

Document

graphql

mutation CreateWaitlist($input: CreateWaitlistInput!) { __typename createWaitlist(input: $input) { __typename userErrors { __typename code field message } waitlist { __typename id slug } } }