createMilestone

A mutation to create a new Milestone on a specific Roadmap.

As with in-app behaviour, you must specify a summary (Milestone Name) when creating a new Milestone. Given that Milestones are associated with a single, specific roadmap, a roadmapID must also be specified in order to create a new Milestone. All other fields are optional.

A Milestone can only have a single date. It cannot include dates ranges (Start and End Dates) or a bucket time.

Sample Mutation

// Create milestone mutation 
mutation {
 createMilestone (
   roadmapID: "5e4d7d53caec436c46595378"
   summary: "Boxing Day Event"
   description: "Boxing Day Door Crashers"
   date: "December 26, 2020"
   milestoneType: "launch"
   fields: [{
     id: "5e4d7d53caec436c465953bc"
     value : "Milestones" 
 }, {
     id: "5e4d7d53caec436c465953cd"
     value : "Target Date"
   }]
 ){
     id
     summary
     description
     date
     account {
       companyName
       billingFirstName
       billingLastName
     }
     roadmap {
       id
       title
       fiscalEndMonth
     }
     fields {
      ...on ItemField {
       fieldID
       fieldName
   }
  }
 }
}

Sample Response

// Create milestone mutation successful result
{
 "data": {
   "createMilestone": {
     "id": "5e4dd01a930df2f65c39a723",
     "summary": "Boxing Day Event",
     "description": "Boxing Day Door Crashers",
     "date": "2020-12-26",
     "account": {
       "companyName": "Roadmunk",
       "billingFirstName": "John",
       "billingLastName": "Smith"
     },
     "roadmap": {
       "id": "5e4d7d53caec436c46595378",
       "title": "Ecommerce Roadmap",
       "fiscalEndMonth": "December"
     },
     "fields": {
     "page": [
    {
       "fieldID": "5e45e4bb8bc5675dc500a37e",
       "fieldName": "Milestone Type"
     },
     {
       "fieldID": "5e4d7d53caec436c465953bc",
       "fieldName": "Theme (Ecommerce Roadmap)"
     },
     {
       "fieldID": "5e4d7d53caec436c465953cd",
       "fieldName": "Owner (Ecommerce Roadmap)"
    }
   ]
  }
 }
}