Create Database Record

POST /v1/create-database-record

Create a record in an explicit database. Unlike create-record, this works on any database – including one with no lists at all – and never guesses which database to use. Pass fieldValues (each { fieldId, kind, value }, kinds matching a field’s type: “text” -> {text} or {html}, “number” -> {number}, “checkbox” -> boolean, “select” -> [optionId], “date” -> {start, end, timezone, granularity}, “assignee”/“reference” -> [id, …]) to set other fields at creation time. If the database has a required creation form, missing required fields are rejected.

Request body

Field	Type	Required	Description
`workspaceId`	string	Yes	The workspace ID
`databaseId`	string	Yes	The database ID (from list-databases)
`title`	string	Yes	The record’s display value (the database’s display field)
`groupOptionId`	string	No	A live option ID on a mounted single-select field (board column). Databases with a migrated list field require an option from that field
`fieldValues`	object[]	No	Other field values to set at creation, each { fieldId, kind, value }

{
  "workspaceId": "string",
  "databaseId": "string",
  "title": "string",
  "groupOptionId": "string",
  "fieldValues": [
    {}
  ]
}

Response

{
  "recordId": "string",
  "databaseId": "string",
  "created": true,
  "joined": true,
  "rank": "string"
}

Example

curl -X POST https://rest.blue.app/v1/create-database-record \
  -H "Authorization: Bearer $BLUE_TOKEN" \
  -H "blue-org-id: $BLUE_ORG_ID" \
  -H "Content-Type: application/json" \
  -d '{"workspaceId":"string","databaseId":"string","title":"string","groupOptionId":"string","fieldValues":[{}]}'