API reference

CreateIncentive

Create an incentive with its rules: what a customer earns and when. Write access, incentives toolset, MCP tool create_incentive.

Access: Write

Variables

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

Input types

CreateIncentiveInput

Field	Type	Required	Accepts	Description
`audience`	`String`	no	One of `NEW`, `RETURNING`	NEW \| RETURNING, or null for everyone — the same wildcard tier uses.
`description`	`String`	no	at most 500 characters
`formId`	`UUID`	no
`limitCount`	`Int`	no	32-bit integer. 1 to 100	Per-customer claim cap. Set it together with limitPeriod, or leave both unset.
`limitPeriod`	`String`	no	One of `DAY`, `WEEK`, `MONTH`, `EVER`, `ORDER`	DAY \| WEEK \| MONTH \| EVER: rolling windows.
`name`	`String!`	yes	1 to 120 characters
`rules`	`JSON`	no	Any JSON value. at most 3 items
`tier`	`String`	no	One of `quick`, `enhanced`

Call it

bash

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

Document

graphql

mutation CreateIncentive($input: CreateIncentiveInput!) { __typename createIncentive(input: $input) { __typename incentiveId userErrors { __typename code field message } } }