> ## Documentation Index > Fetch the complete documentation index at: https://mintlify.com/makenotion/notion-sdk-js/llms.txt > Use this file to discover all available pages before exploring further. # Introduction > Official JavaScript/TypeScript client library for the Notion API

Notion SDK for JavaScript

A simple and easy-to-use client for the Notion API. Build powerful integrations with type-safe TypeScript support, automatic retries, and comprehensive error handling. 

              
                {`const { Client } = require('@notionhq/client')

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

                                const response = await notion.databases.query({
                                database_id: '897e5a76-ae52-4b48'
                                })`}

Quick Start

Get up and running with the Notion SDK in minutes

Install the Notion SDK using your preferred package manager: ```bash npm theme={null} npm install @notionhq/client ``` ```bash yarn theme={null} yarn add @notionhq/client ``` ```bash pnpm theme={null} pnpm add @notionhq/client ``` Go to [Notion's developer portal](https://www.notion.so/my-integrations) and create a new integration to get your API token. Make sure to grant the integration the necessary permissions for your use case. Store your API token securely as an environment variable. Never commit it to version control. Import and initialize the client with your integration token: ```javascript theme={null} const { Client } = require('@notionhq/client') const notion = new Client({ auth: process.env.NOTION_TOKEN }) ``` Start making requests to the Notion API: ```javascript theme={null} const response = await notion.users.list({}) console.log(response.results) ``` ```json theme={null} { "results": [ { "object": "user", "id": "d40e767c-d7af-4b18-a86d-55c61f1e39a4", "type": "person", "person": { "email": "user@example.org" }, "name": "Jane Doe" } ] } ```

Explore by Topic

Learn about the key features and capabilities of the SDK

Set up OAuth flows and manage API tokens for your integration Handle errors gracefully with type-safe error codes and utilities Leverage full TypeScript type definitions for all API operations Efficiently iterate through large result sets with built-in utilities Automatic retry logic for rate limits and transient server errors Distinguish between full and partial API responses with type guards

Ready to build with Notion?

Join thousands of developers building powerful integrations with the Notion API. From simple automation to complex applications, the Notion SDK makes it easy.

Start Building