Skip to main content
Planview Customer Success Center

Create a card

POST /io/card/

Create a card.

Note: copiedFromCardId does not copy the source card's details but will replicate the taskboard and task cards from the source card.

Query Params

Param Type Usage Default
returnFullRecord boolean Returns the full card record false
---
title: Create a card
public: true
repo: core-card-service
verified: 9/10/25
---
# POST /io/card/
Create a card.

Note: copiedFromCardId does not copy the source card's details but will replicate the taskboard and task cards from the source card.

Query Params

Param Type Usage Default
returnFullRecord boolean Returns the full card record false

Example Requests

Minimum Board

Card will be created at the end of the default drop lane with the default card type.

{
  "destination": { "boardId": "1234" },
  "title": "The title of the card"
}

Minimum Lane

Card will be created at the end of the specified lane with the default card type.

{
  "destination": { "laneId": "2345" },
  "title": "The title of the card"
}

Minimum Taskboard

Card will be created at the end of the "TODO" lane on the taskboard of the specified card with the default task card type.

{
  "destination": { "cardId": "3456" },
  "title": "The title of the card"
}

All fields

{
    "actualFinish": null,
    "actualStart": null,
    "plannedStart": "2020-01-20",
    "plannedFinish": "2020-02-01",
    "archivedOn": null,
    "blockedStatus": {
        "isBlocked": true,
        "reason": "The block reason",
        "date": "2019-12-06T21:07:34Z"
    },
    "createdBy": {
        "id": "478440842",
        "emailAddress": "user@leankit.com",
        "fullName": "First Last",
        "avatar": "https://myaccount.leankit.com/avatar/Show/478440842?s=25"
    },
    "updatedBy": {
        "id": "478440842",
        "emailAddress": "user@leankit.com",
        "fullName": "First Last",
        "avatar": "https://myaccount.leankit.com/avatar/Show/478440842?s=25"
    },
    "movedBy": null,
    "archivedBy": null,
    "mirrorSourceCardId": null,
    "isTemplateChanged": false,
    "scoreTotal": null,
    "scoreOverride": null,
    "confidenceTotal": null,
    "scores": null,
    "scoring": {
        "isTemplateChanged": false,
        "scoreTotal": null,
        "scoreOverride": null,
        "confidenceTotal": null,
        "scores": null
    },
    "board": {
        "id": "944576308",
        "title": "Sample Board",
        "version": "42",
        "isArchived": false
    },
    "customIcon": {
        "id": "944576317",
        "title": "Date Dependent",
        "cardColor": "#FFFFFF",
        "iconColor": "212121",
        "iconName": "lk_icons_final_01-13",
        "iconPath": "https://myaccount.leankit.com/customicons/24/212121/lk_icons_final_01-13.png",
        "policy": ""
    },
    "customIconLabel": "Class of Service",
    "color": "#B8CFDF",
    "iconPath": null,
    "createdOn": "2019-12-06T21:07:34Z",
    "description": "The card description",
    "customId": {
        "value": "Card header text",
        "prefix": null,
        "url": null
    },
    "externalLinks": [
        {
            "label": "The link label",
            "url": "https://www.leankit.com"
        }
    ],
    "id": "945261794",
    "index": 1,
    "lane": {
        "cardLimit": 0,
        "description": null,
        "id": "944576326",
        "index": 0,
        "laneClassType": "backlog",
        "laneType": "ready",
        "orientation": "vertical",
        "title": "New Requests",
        "cardStatus": "notStarted",
        "taskBoard": null
    },
    "updatedOn": "2019-12-06T21:07:34Z",
    "movedOn": "2019-12-06T21:07:34Z",
    "priority": "normal",
    "size": 1,
    "tags": [
        "tagOne",
        "tagTwo"
    ],
    "title": "The title of the card",
    "version": "2",
    "type": {
        "id": "944576314",
        "title": "New Feature",
        "cardColor": "#B8CFDF"
    },
    "taskBoardStats": null,
    "subscriptionId": "945261795",
    "commentsCount": 0,
    "childCommentsCount": 0,
    "assignedUsers": [
        {
            "id": "478440842",
            "emailAddress": "user@leankit.com",
            "fullName": "First Last",
            "firstName": "First",
            "lastName": "Last",
            "avatar": "https://myaccount.leankit.com/avatar/Show/478440842?s=25"
        }
    ],
    "assignedTeams": [],
    "attachments": [],
    "comments": [],
    "parentCards": [
        {
            "cardId": "945202295",
            "boardId": "944576308"
        }
    ],
    "customFields": [
        {
            "fieldId": "945250752",
            "type": "text",
            "label": "Custom Field Label",
            "value": "This is the field value"
        }
    ],
    "connectedCardStats": {
        "startedCount": 0,
        "startedSize": 0,
        "notStartedCount": 1,
        "notStartedSize": 1,
        "completedCount": 0,
        "completedSize": 0,
        "blockedCount": 0,
        "totalCount": 1,
        "totalSize": 1,
        "plannedStart": null,
        "plannedFinish": null,
        "actualStart": null,
        "actualFinish": null,
        "pastDueCount": 0,
        "projectedLateCount": 0
    },
    "planningIncrements": [
        {
            "id": "10114179391",
            "label": "PI-1a",
            "startDate": "2021-11-01T00:00:00.000Z",
            "endDate": "2021-11-14T00:00:00.000Z",
            "series": {
                "id": "10114169089",
                "label": "Series 2",
                "timeZone": "Etc/GMT"
            },
            "parent": {
                "id": "10114169189",
                "label": "PI-1"
            }
        },
        {
            "id": "10114169190",
            "label": "PI-2",
            "startDate": "2021-12-01T00:00:00.000Z",
            "endDate": "2021-12-25T00:00:00.000Z",
            "series": {
                "id": "10114169089",
                "label": "Series 2",
                "timeZone": "Etc/GMT"
            },
            "parent": null
        }
    ],
    "externalAssociations": {},
    "policyRuleFieldIdViolations": []
}

Note: boardId, laneId, index properties have been moved into the destination object. For backwards compatibility, when they are provided at the top level, a valid destination is generated.

Example Successful Response

When returnFullRecord is false (default)

201 Created

{
    "id": "945250932"
}

When returnFullRecord is true

201 Created

{
    "actualFinish": null,
    "actualStart": null,
    "plannedStart": "2020-01-20",
    "plannedFinish": "2020-02-01",
    "archivedOn": null,
    "blockedStatus": {
        "isBlocked": true,
        "reason": "The block reason",
        "date": "2019-12-06T21:07:34Z"
    },
    "createdBy": {
        "id": "478440842",
        "emailAddress": "user@leankit.com",
        "fullName": "First Last",
        "avatar": "https://myaccount.leankit.com/avatar/Show/478440842?s=25"
    },
    "updatedBy": {
        "id": "478440842",
        "emailAddress": "user@leankit.com",
        "fullName": "First Last",
        "avatar": "https://myaccount.leankit.com/avatar/Show/478440842?s=25"
    },
    "movedBy": null,
    "archivedBy": null,
    "mirrorSourceCardId": null,
    "isTemplateChanged": false,
    "scoreTotal": null,
    "scoreOverride": null,
    "confidenceTotal": null,
    "scores": null,
    "scoring": {
        "isTemplateChanged": false,
        "scoreTotal": null,
        "scoreOverride": null,
        "confidenceTotal": null,
        "scores": null
    },
    "board": {
        "id": "944576308",
        "title": "Sample Board",
        "version": "42",
        "isArchived": false
    },
    "customIcon": {
        "id": "944576317",
        "title": "Date Dependent",
        "cardColor": "#FFFFFF",
        "iconColor": "212121",
        "iconName": "lk_icons_final_01-13",
        "iconPath": "https://myaccount.leankit.com/customicons/24/212121/lk_icons_final_01-13.png",
        "policy": ""
    },
    "customIconLabel": "Class of Service",
    "color": "#B8CFDF",
    "iconPath": null,
    "createdOn": "2019-12-06T21:07:34Z",
    "description": "The card description",
    "customId": {
        "value": "Card header text",
        "prefix": null,
        "url": null
    },
    "externalLinks": [
        {
            "label": "The link label",
            "url": "https://www.leankit.com"
        }
    ],
    "id": "945261794",
    "index": 1,
    "lane": {
        "cardLimit": 0,
        "description": null,
        "id": "944576326",
        "index": 0,
        "laneClassType": "backlog",
        "laneType": "ready",
        "orientation": "vertical",
        "title": "New Requests",
        "cardStatus": "notStarted",
        "taskBoard": null
    },
    "updatedOn": "2019-12-06T21:07:34Z",
    "movedOn": "2019-12-06T21:07:34Z",
    "priority": "normal",
    "size": 1,
    "tags": [
        "tagOne",
        "tagTwo"
    ],
    "title": "The title of the card",
    "version": "2",
    "type": {
        "id": "944576314",
        "title": "New Feature",
        "cardColor": "#B8CFDF"
    },
    "taskBoardStats": null,
    "subscriptionId": "945261795",
    "commentsCount": 0,
    "childCommentsCount": 0,
    "assignedUsers": [
        {
            "id": "478440842",
            "emailAddress": "user@leankit.com",
            "fullName": "First Last",
            "firstName": "First",
            "lastName": "Last",
            "avatar": "https://myaccount.leankit.com/avatar/Show/478440842?s=25"
        }
    ],
    "assignedTeams": [],
    "attachments": [],
    "comments": [],
    "parentCards": [
        {
            "cardId": "945202295",
            "boardId": "944576308"
        }
    ],
    "customFields": [
        {
            "fieldId": "945250752",
            "type": "text",
            "label": "Custom Field Label",
            "value": "This is the field value"
        }
    ],
    "connectedCardStats": {
        "startedCount": 0,
        "startedSize": 0,
        "notStartedCount": 1,
        "notStartedSize": 1,
        "completedCount": 0,
        "completedSize": 0,
        "blockedCount": 0,
        "totalCount": 1,
        "totalSize": 1,
        "plannedStart": null,
        "plannedFinish": null,
        "actualStart": null,
        "actualFinish": null,
        "pastDueCount": 0,
        "projectedLateCount": 0
    },
    "planningIncrements": [
        {
            "id": "10114179391",
            "label": "PI-1a",
            "startDate": "2021-11-01T00:00:00.000Z",
            "endDate": "2021-11-14T00:00:00.000Z",
            "series": {
                "id": "10114169089",
                "label": "Series 2",
                "timeZone": "Etc/GMT"
            },
            "parent": {
                "id": "10114169189",
                "label": "PI-1"
            }
        },
        {
            "id": "10114169190",
            "label": "PI-2",
            "startDate": "2021-12-01T00:00:00.000Z",
            "endDate": "2021-12-25T00:00:00.000Z",
            "series": {
                "id": "10114169089",
                "label": "Series 2",
                "timeZone": "Etc/GMT"
            },
            "parent": null
        }
    ],
    "externalAssociations": {},
    "policyRuleFieldIdViolations": []
}



Updated 2025-09-12 @ 10:09 AM