Customer journey
Create customer journey maps with stages, activities, and satisfaction metrics.
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
idstringrequiredUnique UUID for the journey map
titlestringrequiredTitle of the customer journey
creatorstringnull
createDatestringnull
updateDatestringnull
themestring"default"
cellWidthinteger200
stageNamestring"Journey Stages"
stageColorstring"#616161"
stagesobject[]requiredJourney stages with id, stage name, color (#hex), fontColor ("white" or "black")
Child attributes
idstringstagestringdefaultbooleanaddbooleancolorstringfontColorstringsectionsobject[]requiredSections: 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
stagestringrequiredThe column; made when the map has none by that name.
rowstringA text row by its name, like Pain points; made when there is none. The first text row when left out.
textstringrequiredkeystringYour 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"
}
}