Skip to content
MockFlow DevelopersGet an API key

Create customer journey maps with stages, activities, and satisfaction metrics.

Updated 9 Nov 20262 min read

Send "type": "customer_journey".

Create customer journey maps with stages, activities, and satisfaction metrics.

Also available as the MCP tool render_customerjourney. The same payload works through either surface.

Fields

data
idstringrequired

Unique UUID for the journey map

titlestringrequired

Title of the customer journey

creatorstring

null

createDatestring

null

updateDatestring

null

themestring

"default"

cellWidthinteger

200

stageNamestring

"Journey Stages"

stageColorstring

"#616161"

stagesobject[]required

Journey stages with id, stage name, color (#hex), fontColor ("white" or "black")

Child attributes
idstring
stagestring
defaultboolean
addboolean
colorstring
fontColorstring
sectionsobject[]required

Sections: type 'icon' (activities with FontAwesome icons), 'graph' (satisfaction 0-4), or 'text' (HTML content). Items keyed by stage ID.

Example

{
  "type": "customer_journey",
  "data": {
    "id": "string",
    "title": "Q4 Launch Planning",
    "creator": "string",
    "createDate": "string",
    "updateDate": "string",
    "theme": "string",
    "cellWidth": 0,
    "stageName": "Q4 Launch Planning",
    "stages": [
      {
        "id": "string",
        "stage": "string",
        "default": false,
        "add": false,
        "color": "string",
        "fontColor": "string"
      }
    ],
    "sections": [
      {}
    ]
  }
}

Add one record

POST /boards/{boardId}/items/{itemId}/records adds one of these to an item already on a board and leaves the rest of it as it is. Send the same key again to update that record instead of adding another.

Record fields

record
stagestringrequired

The column; made when the map has none by that name.

rowstring

A text row by its name, like Pain points; made when there is none. The first text row when left out.

textstringrequired
keystring

Your own id for this record, like an issue key. Sending the same key again updates and moves that record instead of adding another.

{
  "record": {
    "stage": "string",
    "row": "string",
    "text": "Interview 5 users",
    "key": "string"
  }
}
Was this page helpful?

Sign in to MockFlow

The same account you use in the app and on the API.

Forgot your password?
or
Continue with GoogleContinue with MicrosoftContinue with Apple