The Blue API allows you to create records in Blue and add data to custom fields at the same time.
To create a record in Blue with just a title and a list, you can use the following mutation:
mutation CreateRecord {
createTodo(
input: {
todoListId:"TODOLISTID",
title: "Test",
position: 65535
}
) {
id
title
position
}
}
To create a record with a title, list, and custom fields, you can use the following mutation. Note that you will have to use the list custom fields query to get the custom field IDs first that you want to add to the record.
mutation CreateTodoWithCustomField {
createTodo(
input: {
todoListId: "TODOLISTID"
title: "Backlog"
placement: TOP // or BOTTOM
tags: [
{
tagId: "cso9pzftzd3cimn7x4olxm43"
},
{
"tagTitle": "Feature"
},
{
"tagTitle": "Refactor",
"tagColor": "#b4e051"
},
{
"tagTitle": "This is a new tag"
},
{
"tagTitle": "This is another new tag",
"tagColor": "#ff4b4b"
}
]
customFields: [
{
customFieldId: "cm4m651p1000tov26g7pjz3mt"
value: "2025-01-22"
}
{
customFieldId: "cm4m651p1000tov26g7pjz3mt"
value: "2025-01-21 03:45 PM, 2025-01-22 05:00 PM"
}
{
customFieldId: "cm6671mfz0008n5weztls6vkw"
value: "[email protected]"
}
{
customFieldId: "cm6674tjc000kn5nsfrvr2kyg"
value: "+1234567890"
}
]
}
) {
id
title
position
}
}
Here's a table explaining the input fields for creating a record:
| Field | Type | Description |
|---|---|---|
| todoListId | String | The ID of the todo list where the record will be created |
| title | String | The title of the record |
| position | Integer | The position of the record in the list (default is 65535 for end of list) |
| placement | String | The placement of the record in the list (TOP or BOTTOM) |
| tags | Array | An array of tag objects that can include existing tags (by tagId) or create new tags (with tagTitle and optional tagColor) |
| customFieldId | String | The ID of the custom field to set a value for |
| value | String | The value to set for the custom field |
Note: The position and placement fields can be optionally included to specify the record's placement in the list.