From 3bf8bfca9584831f3d24bfd8f28085e2cf263e60 Mon Sep 17 00:00:00 2001
From: Jess Mitchell <jess@jessmitchell.ca>
Date: Wed, 6 Sep 2023 17:03:50 -0400
Subject: [PATCH] Add 'Intro to Notion API' example (#441)

* add new example (wip)

* update readme

* add intermediate example

* add more comments and resources to each example

* add additional resources section

* rename some files for consistency, clean up readme, more console logs

* make linter happy

* readme updates

* clean up links

* add console for querying
---
 examples/intro-to-notion-api/.env.example     |   2 +
 examples/intro-to-notion-api/README.md        |  97 +++++++++++++++
 .../intro-to-notion-api/assets/page_id.png    | Bin 0 -> 39795 bytes
 .../intro-to-notion-api/basic/1-add-block.js  |  45 +++++++
 .../basic/2-add-linked-block.js               |  62 ++++++++++
 .../basic/3-add-styled-block.js               |  70 +++++++++++
 .../intermediate/1-create-a-database.js       |  59 ++++++++++
 .../intermediate/2-add-page-to-database.js    |  81 +++++++++++++
 .../intermediate/3-query-database.js          | 102 ++++++++++++++++
 .../intermediate/4-sort-database.js           | 110 ++++++++++++++++++
 .../intermediate/sampleData.js                |  44 +++++++
 examples/intro-to-notion-api/package.json     |  24 ++++
 12 files changed, 696 insertions(+)
 create mode 100644 examples/intro-to-notion-api/.env.example
 create mode 100644 examples/intro-to-notion-api/README.md
 create mode 100644 examples/intro-to-notion-api/assets/page_id.png
 create mode 100644 examples/intro-to-notion-api/basic/1-add-block.js
 create mode 100644 examples/intro-to-notion-api/basic/2-add-linked-block.js
 create mode 100644 examples/intro-to-notion-api/basic/3-add-styled-block.js
 create mode 100644 examples/intro-to-notion-api/intermediate/1-create-a-database.js
 create mode 100644 examples/intro-to-notion-api/intermediate/2-add-page-to-database.js
 create mode 100644 examples/intro-to-notion-api/intermediate/3-query-database.js
 create mode 100644 examples/intro-to-notion-api/intermediate/4-sort-database.js
 create mode 100644 examples/intro-to-notion-api/intermediate/sampleData.js
 create mode 100644 examples/intro-to-notion-api/package.json

diff --git a/examples/intro-to-notion-api/.env.example b/examples/intro-to-notion-api/.env.example
new file mode 100644
index 00000000..b8f71102
--- /dev/null
+++ b/examples/intro-to-notion-api/.env.example
@@ -0,0 +1,2 @@
+NOTION_API_KEY=<your-notion-api-key>
+NOTION_PAGE_ID=<notion-page-id>
\ No newline at end of file
diff --git a/examples/intro-to-notion-api/README.md b/examples/intro-to-notion-api/README.md
new file mode 100644
index 00000000..8409c6df
--- /dev/null
+++ b/examples/intro-to-notion-api/README.md
@@ -0,0 +1,97 @@
+# Introduction to using Notion's SDK for JavaScript
+
+## Learn how to make Public API requests
+
+Use this sample code to learn how to make Public API requests with varying degrees of difficulty.
+
+The sample code is split into two sections:
+
+1. `basic`
+2. `intermediate`
+
+(An `advanced` section will soon be added, as well.)
+
+If you are new to Notion's SDK for JavaScript, start with the code samples in the `/basic` directory to get more familiar to basic concepts.
+
+The files in each directory will build on each other to increase in complexity. For example, in `/intermediate`, first you will see how to create a database, then how to create a database and add a page to it, and finally create a database, add a page, and query/sort the database.
+
+## Table of contents
+
+In case you are looking for example code for a specific task, the files are divided as follows:
+
+- `/basic/1-add-block.js`: Create a new block and append it to an existing Notion page.
+- `/basic/2-add-linked-block.js`: Create and append new blocks, and add a link to the text of a new block.
+- `/basic/3-add-styled-block.js`: Create and append new blocks, and apply text styles to them.
+- `/intermediate/1-create-a-database.js`: Create a new database with defined properties.
+- `/intermediate/2-add-page-to-database.js`: Create a new database and add new pages to it.
+- `/intermediate/3-query-database.js`: Create a new database, add pages to it, and filter the database entries (pages).
+- `/intermediate/4-sort-database.js`: Create a new database, add pages to it, and filter/sort the database entries (pages).
+
+## Running locally
+
+### 1. Clone project and install dependencies
+
+To use this example on your machine, clone the repo and move into your local copy:
+
+```zsh
+git clone https://github.com/makenotion/notion-sdk-js.git
+cd /notion-sdk-js
+```
+
+Next, move into this example in the `/examples` directory, and install its dependencies:
+
+```zsh
+cd /examples/intro-to-notion-api
+npm install
+```
+
+### 2. Set your environment variables in a `.env` file
+
+A `.env.example` file has been included and can be renamed `.env` (or you can run `cp .env.example .env` to copy the file).
+
+Update the environment variables below:
+
+```zsh
+NOTION_API_KEY=<your-notion-api-key>
+NOTION_PAGE_ID=<notion-page-id>
+```
+
+`NOTION_API_KEY`: Create a new integration in the [integrations dashboard](https://www.notion.com/my-integrations) and retrieve the API key from the integration's `Secrets` page.
+
+`NOTION_PAGE_ID`: Use the ID of any Notion page that you want to test adding content to.
+
+The page ID is the 32 character string at the end of any page URL.
+![A Notion page URL with the ID highlighted](./assets/page_id.png)
+
+### 3. Give the integration access to your page
+
+Your Notion integration will need permission to interact with the Notion page being used for your `NOTION_PAGE_ID` variable. To provide access, do the following:
+
+1. Go to the page in your workspace.
+2. Click the `•••` (more menu) on the top-right corner of the page.
+3. Scroll to the bottom of the menu and click `Add connections`.
+4. Search for and select your integration in the `Search for connections...` menu.
+
+Once selected, your integration will have permission to read content from the page.
+
+**If you are receiving authorization errors, make sure the integration has permission to access the page.**
+
+### 3. Run individual examples
+
+To run each individual example, use the `node` command with the file's path.
+
+For example:
+
+```zsh
+node /basic/1-add-block.js
+```
+
+---
+
+## Additional resources
+
+To learn more, read the [Public API docs](https://developers.notion.com/) for additional information on using Notion's API. The API docs include a series of [guides](https://developers.notion.com/docs) and the [API reference](https://developers.notion.com/reference/intro), which has a full list of available endpoints.
+
+To see more examples of what you can build with Notion, see our other sample integrations in the parent `/examples` directory. To learn how to build an internal integration with an interactive frontend, read the [Build your first integration](https://developers.notion.com/docs/create-a-notion-integration) guide.
+
+To connect with other developers building with Notion, join the [Notion Developers Slack group](https://join.slack.com/t/notiondevs/shared_invite/zt-20b5996xv-DzJdLiympy6jP0GGzu3AMg).
diff --git a/examples/intro-to-notion-api/assets/page_id.png b/examples/intro-to-notion-api/assets/page_id.png
new file mode 100644
index 0000000000000000000000000000000000000000..d0e837b64995dfa5bd81d93dfeeb9d2ccbcf4416
GIT binary patch
literal 39795
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
IWEt{*05e!gY5)KL

literal 0
HcmV?d00001

diff --git a/examples/intro-to-notion-api/basic/1-add-block.js b/examples/intro-to-notion-api/basic/1-add-block.js
new file mode 100644
index 00000000..a245215d
--- /dev/null
+++ b/examples/intro-to-notion-api/basic/1-add-block.js
@@ -0,0 +1,45 @@
+import { Client } from "@notionhq/client"
+import { config } from "dotenv"
+
+config()
+
+const pageId = process.env.NOTION_PAGE_ID
+const apiKey = process.env.NOTION_API_KEY
+
+const notion = new Client({ auth: apiKey })
+
+/* 
+---------------------------------------------------------------------------
+*/
+
+/**
+ * Resources:
+ * - Appending block children endpoint (notion.blocks.children.append(): https://developers.notion.com/reference/patch-block-children)
+ * - Working with page content guide: https://developers.notion.com/docs/working-with-page-content
+ */
+
+async function main() {
+  const blockId = pageId // Blocks can be appended to other blocks *or* pages. Therefore, a page ID can be used for the block_id parameter
+  const newHeadingResponse = await notion.blocks.children.append({
+    block_id: blockId,
+    // Pass an array of blocks to append to the page: https://developers.notion.com/reference/block#block-type-objects
+    children: [
+      {
+        heading_2: {
+          rich_text: [
+            {
+              text: {
+                content: "Types of kale", // This is the text that will be displayed in Notion
+              },
+            },
+          ],
+        },
+      },
+    ],
+  })
+
+  // Print the new block(s) response
+  console.log(newHeadingResponse)
+}
+
+main()
diff --git a/examples/intro-to-notion-api/basic/2-add-linked-block.js b/examples/intro-to-notion-api/basic/2-add-linked-block.js
new file mode 100644
index 00000000..54424b23
--- /dev/null
+++ b/examples/intro-to-notion-api/basic/2-add-linked-block.js
@@ -0,0 +1,62 @@
+import { Client } from "@notionhq/client"
+import { config } from "dotenv"
+
+config()
+
+const pageId = process.env.NOTION_PAGE_ID
+const apiKey = process.env.NOTION_API_KEY
+
+const notion = new Client({ auth: apiKey })
+
+/* 
+---------------------------------------------------------------------------
+*/
+
+/**
+ * Resources:
+ * - Appending block children endpoint (notion.blocks.children.append(): https://developers.notion.com/reference/patch-block-children)
+ * - Rich text options: https://developers.notion.com/reference/rich-text
+ * - Working with page content guide: https://developers.notion.com/docs/working-with-page-content
+ */
+
+async function main() {
+  const blockId = pageId // Blocks can be appended to other blocks *or* pages. Therefore, a page ID can be used for the block_id parameter
+  const linkedTextResponse = await notion.blocks.children.append({
+    block_id: blockId,
+    // Pass an array of blocks to append to the page: https://developers.notion.com/reference/block#block-type-objects
+    children: [
+      {
+        heading_3: {
+          rich_text: [
+            {
+              text: {
+                content: "Tuscan  kale", // This is the text that will be displayed in Notion
+              },
+            },
+          ],
+        },
+      },
+      {
+        paragraph: {
+          rich_text: [
+            {
+              text: {
+                content:
+                  "Tuscan  kale is a variety of kale with a long tradition in Italian cuisine, especially that of Tuscany. It is also known as Tuscan kale, Italian kale, dinosaur kale, kale, flat back kale, palm tree kale, or black Tuscan palm.",
+                link: {
+                  // Include a url to make the paragraph a link in Notion
+                  url: "https://en.wikipedia.org/wiki/Kale",
+                },
+              },
+            },
+          ],
+        },
+      },
+    ],
+  })
+
+  // Print the new block(s) response
+  console.log(linkedTextResponse)
+}
+
+main()
diff --git a/examples/intro-to-notion-api/basic/3-add-styled-block.js b/examples/intro-to-notion-api/basic/3-add-styled-block.js
new file mode 100644
index 00000000..7919638e
--- /dev/null
+++ b/examples/intro-to-notion-api/basic/3-add-styled-block.js
@@ -0,0 +1,70 @@
+import { Client } from "@notionhq/client"
+import { config } from "dotenv"
+
+config()
+
+const pageId = process.env.NOTION_PAGE_ID
+const apiKey = process.env.NOTION_API_KEY
+
+const notion = new Client({ auth: apiKey })
+
+/* 
+---------------------------------------------------------------------------
+*/
+
+/**
+ * Resources:
+ * - Appending block children endpoint (notion.blocks.children.append(): https://developers.notion.com/reference/patch-block-children)
+ * - Rich text options: https://developers.notion.com/reference/rich-text
+ * - Working with page content guide: https://developers.notion.com/docs/working-with-page-content
+ */
+
+async function main() {
+  const blockId = pageId // Blocks can be appended to other blocks *or* pages. Therefore, a page ID can be used for the block_id parameter
+  const styledLinkTextResponse = await notion.blocks.children.append({
+    block_id: blockId,
+    children: [
+      {
+        heading_3: {
+          rich_text: [
+            {
+              text: {
+                content: "Tuscan  kale",
+              },
+            },
+          ],
+        },
+      },
+      {
+        paragraph: {
+          rich_text: [
+            {
+              text: {
+                // Paragraph text
+                content:
+                  "Tuscan  kale is a variety of kale with a long tradition in Italian cuisine, especially that of Tuscany. It is also known as Tuscan kale, Italian kale, dinosaur kale, kale, flat back kale, palm tree kale, or black Tuscan palm.",
+                link: {
+                  // Paragraph link
+                  url: "https://en.wikipedia.org/wiki/Kale",
+                },
+              },
+              annotations: {
+                // Paragraph styles
+                bold: true,
+                italic: true,
+                strikethrough: true,
+                underline: true,
+                color: "green",
+              },
+            },
+          ],
+        },
+      },
+    ],
+  })
+
+  // Print the new block(s) response
+  console.log(styledLinkTextResponse)
+}
+
+main()
diff --git a/examples/intro-to-notion-api/intermediate/1-create-a-database.js b/examples/intro-to-notion-api/intermediate/1-create-a-database.js
new file mode 100644
index 00000000..589a403b
--- /dev/null
+++ b/examples/intro-to-notion-api/intermediate/1-create-a-database.js
@@ -0,0 +1,59 @@
+import { Client } from "@notionhq/client"
+import { config } from "dotenv"
+
+config()
+
+const pageId = process.env.NOTION_PAGE_ID
+const apiKey = process.env.NOTION_API_KEY
+
+const notion = new Client({ auth: apiKey })
+
+/* 
+---------------------------------------------------------------------------
+*/
+
+/**
+ * Resources:
+ * - Create a database endpoint (notion.databases.create(): https://developers.notion.com/reference/create-a-database)
+ * - Working with databases guide: https://developers.notion.com/docs/working-with-databases
+ */
+
+async function main() {
+  // Create a new database
+  const newDatabase = await notion.databases.create({
+    parent: {
+      type: "page_id",
+      page_id: pageId,
+    },
+    title: [
+      {
+        type: "text",
+        text: {
+          content: "New database name",
+        },
+      },
+    ],
+    properties: {
+      // These properties represent columns in the database (i.e. its schema)
+      "Grocery item": {
+        type: "title",
+        title: {},
+      },
+      Price: {
+        type: "number",
+        number: {
+          format: "dollar",
+        },
+      },
+      "Last ordered": {
+        type: "date",
+        date: {},
+      },
+    },
+  })
+
+  // Print the new database response
+  console.log(newDatabase)
+}
+
+main()
diff --git a/examples/intro-to-notion-api/intermediate/2-add-page-to-database.js b/examples/intro-to-notion-api/intermediate/2-add-page-to-database.js
new file mode 100644
index 00000000..5d1ab132
--- /dev/null
+++ b/examples/intro-to-notion-api/intermediate/2-add-page-to-database.js
@@ -0,0 +1,81 @@
+import { Client } from "@notionhq/client"
+import { config } from "dotenv"
+import { propertiesForNewPages } from "./sampleData.js"
+
+config()
+
+const pageId = process.env.NOTION_PAGE_ID
+const apiKey = process.env.NOTION_API_KEY
+
+const notion = new Client({ auth: apiKey })
+
+/* 
+---------------------------------------------------------------------------
+*/
+
+/**
+ * Resources:
+ * - Create a database endpoint (notion.databases.create(): https://developers.notion.com/reference/create-a-database)
+ * - Create a page endpoint (notion.pages.create(): https://developers.notion.com/reference/post-page)
+ * - Working with databases guide: https://developers.notion.com/docs/working-with-databases
+ */
+
+async function addNotionPageToDatabase(databaseId, pageProperties) {
+  const newPage = await notion.pages.create({
+    parent: {
+      database_id: databaseId,
+    },
+    properties: pageProperties,
+  })
+  console.log(newPage)
+}
+
+async function main() {
+  // Create a new database
+  const newDatabase = await notion.databases.create({
+    parent: {
+      type: "page_id",
+      page_id: pageId,
+    },
+    title: [
+      {
+        type: "text",
+        text: {
+          content: "Grocery list",
+        },
+      },
+    ],
+    properties: {
+      // These properties represent columns in the database (i.e. its schema)
+      "Grocery item": {
+        type: "title",
+        title: {},
+      },
+      Price: {
+        type: "number",
+        number: {
+          format: "dollar",
+        },
+      },
+      "Last ordered": {
+        type: "date",
+        date: {},
+      },
+    },
+  })
+
+  // Print the new database's URL. Visit the URL in your browser to see the pages that get created in the next step.
+  console.log(newDatabase.url)
+
+  const databaseId = newDatabase.id
+  // If there is no ID (if there's an error), return.
+  if (!databaseId) return
+
+  console.log("Adding new pages...")
+  for (let i = 0; i < propertiesForNewPages.length; i++) {
+    // Add a few new pages to the database that was just created
+    await addNotionPageToDatabase(databaseId, propertiesForNewPages[i])
+  }
+}
+
+main()
diff --git a/examples/intro-to-notion-api/intermediate/3-query-database.js b/examples/intro-to-notion-api/intermediate/3-query-database.js
new file mode 100644
index 00000000..535d3716
--- /dev/null
+++ b/examples/intro-to-notion-api/intermediate/3-query-database.js
@@ -0,0 +1,102 @@
+import { Client } from "@notionhq/client"
+import { config } from "dotenv"
+import { propertiesForNewPages } from "./sampleData.js"
+
+config()
+
+const pageId = process.env.NOTION_PAGE_ID
+const apiKey = process.env.NOTION_API_KEY
+
+const notion = new Client({ auth: apiKey })
+
+/* 
+---------------------------------------------------------------------------
+*/
+
+/**
+ * Resources:
+ * - Create a database endpoint (notion.databases.create(): https://developers.notion.com/reference/create-a-database)
+ * - Create a page endpoint (notion.pages.create(): https://developers.notion.com/reference/post-page)
+ * - Working with databases guide: https://developers.notion.com/docs/working-with-databases
+ * Query a database: https://developers.notion.com/reference/post-database-query
+ * Filter database entries: https://developers.notion.com/reference/post-database-query-filter
+ */
+
+async function addNotionPageToDatabase(databaseId, pageProperties) {
+  await notion.pages.create({
+    parent: {
+      database_id: databaseId,
+    },
+    properties: pageProperties, // Note: Page properties must match the schema of the database
+  })
+}
+
+async function queryDatabase(databaseId) {
+  console.log("Querying database...")
+  // This query will filter database entries and return pages that have a "Last ordered" property that is more recent than 2022-12-31. Use multiple filters with the AND/OR options: https://developers.notion.com/reference/post-database-query-filter.
+  const lastOrderedIn2023 = await notion.databases.query({
+    database_id: databaseId,
+    filter: {
+      property: "Last ordered",
+      date: {
+        after: "2022-12-31",
+      },
+    },
+  })
+
+  // Print filtered results
+  console.log('Pages with the "Last ordered" date after 2022-12-31:')
+  console.log(lastOrderedIn2023)
+}
+
+async function main() {
+  // Create a new database
+  const newDatabase = await notion.databases.create({
+    parent: {
+      type: "page_id",
+      page_id: pageId,
+    },
+    title: [
+      {
+        type: "text",
+        text: {
+          content: "Grocery list",
+        },
+      },
+    ],
+    properties: {
+      // These properties represent columns in the database (i.e. its schema)
+      "Grocery item": {
+        type: "title",
+        title: {},
+      },
+      Price: {
+        type: "number",
+        number: {
+          format: "dollar",
+        },
+      },
+      "Last ordered": {
+        type: "date",
+        date: {},
+      },
+    },
+  })
+  // Print the new database's URL. Visit the URL in your browser to see the pages that get created in the next step.
+  console.log(newDatabase.url)
+
+  const databaseId = newDatabase.id
+  // If there is no ID (if there's an error), return.
+  if (!databaseId) return
+
+  console.log("Adding new pages...")
+  for (let i = 0; i < propertiesForNewPages.length; i++) {
+    // Add a few new pages to the database that was just created
+    await addNotionPageToDatabase(databaseId, propertiesForNewPages[i])
+  }
+
+  // After adding pages, query the database entries (pages)
+  queryDatabase(databaseId)
+}
+
+main()
diff --git a/examples/intro-to-notion-api/intermediate/4-sort-database.js b/examples/intro-to-notion-api/intermediate/4-sort-database.js
new file mode 100644
index 00000000..36b3ffe4
--- /dev/null
+++ b/examples/intro-to-notion-api/intermediate/4-sort-database.js
@@ -0,0 +1,110 @@
+import { Client } from "@notionhq/client"
+import { config } from "dotenv"
+import { propertiesForNewPages } from "./sampleData.js"
+
+config()
+
+const pageId = process.env.NOTION_PAGE_ID
+const apiKey = process.env.NOTION_API_KEY
+
+const notion = new Client({ auth: apiKey })
+
+/* 
+---------------------------------------------------------------------------
+*/
+
+/**
+ * Resources:
+ * - Create a database endpoint (notion.databases.create(): https://developers.notion.com/reference/create-a-database)
+ * - Create a page endpoint (notion.pages.create(): https://developers.notion.com/reference/post-page)
+ * - Working with databases guide: https://developers.notion.com/docs/working-with-databases
+ * Query a database: https://developers.notion.com/reference/post-database-query
+ * Filter database entries: https://developers.notion.com/reference/post-database-query-filter
+ * Sort database entries: https://developers.notion.com/reference/post-database-query-sort
+ */
+
+async function addNotionPageToDatabase(databaseId, pageProperties) {
+  await notion.pages.create({
+    parent: {
+      database_id: databaseId,
+    },
+    properties: pageProperties, // Note: Page properties must match the schema of the database
+  })
+}
+
+async function queryAndSortDatabase(databaseId) {
+  console.log("Querying database...")
+  // This query will filter and sort database entries. The returned pages will have a "Last ordered" property that is more recent than 2022-12-31. Any database property can be filtered or sorted. Pass multiple sort objects to the "sorts" array to apply more than one sorting rule.
+  const lastOrderedIn2023Alphabetical = await notion.databases.query({
+    database_id: databaseId,
+    filter: {
+      property: "Last ordered",
+      date: {
+        after: "2022-12-31",
+      },
+    },
+    sorts: [
+      {
+        property: "Grocery item",
+        direction: "descending",
+      },
+    ],
+  })
+
+  // Print filtered/sorted results
+  console.log(
+    'Pages with the "Last ordered" date after 2022-12-31 in descending order:'
+  )
+  console.log(lastOrderedIn2023Alphabetical)
+}
+
+async function main() {
+  // Create a new database
+  const newDatabase = await notion.databases.create({
+    parent: {
+      type: "page_id",
+      page_id: pageId,
+    },
+    title: [
+      {
+        type: "text",
+        text: {
+          content: "Grocery list",
+        },
+      },
+    ],
+    properties: {
+      // These properties represent columns in the database (i.e. its schema)
+      "Grocery item": {
+        type: "title",
+        title: {},
+      },
+      Price: {
+        type: "number",
+        number: {
+          format: "dollar",
+        },
+      },
+      "Last ordered": {
+        type: "date",
+        date: {},
+      },
+    },
+  })
+  // Print the new database's URL. Visit the URL in your browser to see the pages that get created in the next step.
+  console.log(newDatabase.url)
+
+  const databaseId = newDatabase.id
+  if (!databaseId) return
+
+  console.log("Adding new pages...")
+  for (let i = 0; i < propertiesForNewPages.length; i++) {
+    // Add a few new pages to the database that was just created
+    await addNotionPageToDatabase(databaseId, propertiesForNewPages[i])
+  }
+
+  // After adding pages, query the database entries (pages) and sort the results
+  queryAndSortDatabase(databaseId)
+}
+
+main()
diff --git a/examples/intro-to-notion-api/intermediate/sampleData.js b/examples/intro-to-notion-api/intermediate/sampleData.js
new file mode 100644
index 00000000..4d03353c
--- /dev/null
+++ b/examples/intro-to-notion-api/intermediate/sampleData.js
@@ -0,0 +1,44 @@
+export const propertiesForNewPages = [
+  {
+    "Grocery item": {
+      type: "title",
+      title: [{ type: "text", text: { content: "Tomatoes" } }],
+    },
+    Price: {
+      type: "number",
+      number: 1.49,
+    },
+    "Last ordered": {
+      type: "date",
+      date: { start: "2023-05-11" },
+    },
+  },
+  {
+    "Grocery item": {
+      type: "title",
+      title: [{ type: "text", text: { content: "Lettuce" } }],
+    },
+    Price: {
+      type: "number",
+      number: 3.99,
+    },
+    "Last ordered": {
+      type: "date",
+      date: { start: "2023-05-04" },
+    },
+  },
+  {
+    "Grocery item": {
+      type: "title",
+      title: [{ type: "text", text: { content: "Oranges" } }],
+    },
+    Price: {
+      type: "number",
+      number: 0.99,
+    },
+    "Last ordered": {
+      type: "date",
+      date: { start: "2022-04-29" },
+    },
+  },
+]
diff --git a/examples/intro-to-notion-api/package.json b/examples/intro-to-notion-api/package.json
new file mode 100644
index 00000000..ad005d27
--- /dev/null
+++ b/examples/intro-to-notion-api/package.json
@@ -0,0 +1,24 @@
+{
+  "name": "intro-to-notion-api",
+  "version": "1.0.0",
+  "description": "Introductory examples of using Notion's public API via the Notion SDK for JavaScript.",
+  "main": "index.js",
+  "type": "module",
+  "scripts": {
+    "test": "echo \"Error: no test specified\" && exit 1",
+    "start": ""
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/makenotion/notion-sdk-js.git"
+  },
+  "author": "Jess Mitchell",
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/makenotion/notion-sdk-js/issues"
+  },
+  "dependencies": {
+    "@notionhq/client": "file:../..",
+    "dotenv": "^16.3.1"
+  }
+}