# CreateWaitlist

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

**Access:** [Write](https://developer.missin.co.uk/get-started/authentication.md#access-levels)

## 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
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 } } }
```

Source: https://developer.missin.co.uk/reference/waitlists/create-waitlist