Notion API: Notion API, update a checkbox value in a database

Join the AI Workshop to learn more about AI and how it can be applied to web development. Next cohort February 1st, 2026

The AI-first Web Development BOOTCAMP cohort starts February 24th, 2026. 10 weeks of intensive training and hands-on projects.


Here’s how to update a checkbox value in a Notion database using the Notion API.

Each entry is considered to be a page.

So once you have that entry, let’s assume it to be the variable named page, you’ll have its id under page.id

I’ll also assume you have the Notion client initialized.

import { Client } from '@notionhq/client'

//...

const notion = new Client({ auth: process.env.NOTION_API_KEY })

Then you can do this to set the value of the checkbox named “Ready” to true:

await notion.pages.update({
  page_id: page.id,
  properties: {
    Ready: {
      checkbox: true,
    },
  },
})

Lessons in this unit:

0: Introduction
1: Notion API, how to retrieve the entries in a database
2: Notion API, select all pages with a specific emoji
3: ▶︎ Notion API, update a checkbox value in a database
4: Notion API, update the icon emoji of a page