API reference

CreateCampaign

Create a campaign; body needs name, campaign_type_id and start_date. Invalid input returns… Write access, campaigns toolset, MCP tool create_campaign.

Create a campaign; body needs name, campaign_type_id and start_date. Invalid input returns userErrors.

Access: Write

Variables

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

Input types

`body`

Field	Type	Required	Accepts
`campaign_type_id`	string (uuid)	yes
`name`	string	yes	1 to 120 characters
`start_date`	any	yes
`end_date`	any or null	no
`status`	string	no	One of `ACTIVE`, `DRAFT`, `ARCHIVED`, `PAUSED`, `ENDED`, `COMPLETED`
`allocated_budget`	number or null	no	0 to 1000000000
`utm_campaign`	string or null	no	at most 120 characters
`utm_term`	string or null	no	at most 120 characters
`icon`	string or null	no	One of `megaphone`, `sparkles`, `rocket`, `flag`, `star`, `heart`, `bell`, `party-popper`, `gift`, `tag`, `ticket`, `percent`, `badge-percent`, `shopping-bag`, `shopping-cart`, `package`, `truck`, `store`, `sun`, `snowflake`, `leaf`, `flower`, `sprout`, `umbrella`, `moon`, `tree-pine`, `egg`, `ghost`, `cake`, `trophy`, `crown`, `gem`, `award`, `medal`, `calendar`, `calendar-heart`, `camera`, `video`, `clapperboard`, `music`, `mic`, `palette`, `shirt`, `watch`, `globe`, `map-pin`, `plane`, `users`, `handshake`, `target`, `trending-up`, `zap`, `flame`, `coffee`, `dumbbell`, `gamepad-2`
`icon_color`	string or null	no	One of `default`, `gray`, `brown`, `orange`, `yellow`, `green`, `blue`, `purple`, `pink`, `red`

Call it

bash

curl https://api.missin.co.uk/graphql/v1 \
  -H "Authorization: Bearer $MISSIN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"operationName":"CreateCampaign","variables":{"body":{"campaign_type_id":"00000000-0000-0000-0000-000000000000","name":"Example","start_date":"2026-01-01"}},"extensions":{"persistedQuery":{"version":1,"sha256Hash":"1aa0bf5d1b9afe827b94b0cbe6718bd1ad962938a2a34ca9df6fa57732fbca83"}}}'

Document

graphql

mutation CreateCampaign($body: JSON!) { __typename createCampaign(input: {body: $body}) { __typename campaign { __typename campaignSlug id name rowId status } campaignId campaignSlug userErrors { __typename code field message } } }