# Notion Node (WIP)

## 📌 예시 워크플로우

![Image](https://upload.cafenono.com/image/slashpageHome/20250422/093758_DpLDaCc81SRsUJI4yJ?q=80&s=1280x180&t=outside&f=webp)

예시 워크플로우 다운로드

Notion_Node.json

[https://slashpage.com/n8n-guide/n8pw9x2zdxppy2g7yrqv](https://slashpage.com/n8n-guide/n8pw9x2zdxppy2g7yrqv)

## 📌 Notion Node 개요

### Notion Node란?

- n8n에서 **Notion API**를 활용해 Notion 데이터베이스와 상호작용할 수 있도록 도와주는 자동화 노드

- Notion의 페이지와 데이터베이스를 자동으로 생성, 조회, 수정, 삭제하는 등의 작업을 수행할 수 있음

- 반복적인 수작업을 줄이고, 다른 서비스와 연동하여 생산성을 최적화 할 수 있음!

### Notion Node를 통해 가능한 작업들

✅ 페이지 관련 기능: Notion 페이지를 생성, 검색하고 블록을 추가하거나 수정 가능

✅ 데이터베이스 관련 기능: 데이터베이스 조회, 검색, 페이지 추가 및 수정 가능

✅ 사용자 관련 기능: Notion 사용자 목록 조회 가능

## 📌 사전 준비

### Notion API KEY 발급

step1) Notion에서 **Integration**을 생성

detail

  에 접속하여 로그인 

새 API 통합 버튼을 클릭

![Image](https://upload.cafenono.com/image/slashpageHome/20250422/093759_px1y0dILyTNUn01i3u?q=80&s=1280x180&t=outside&f=webp)

step2) Integration의 API Key를 발급

detail

API 통합 이름과 관련 워크스페이스를 설정 후, 저장 클릭

![Image](https://upload.cafenono.com/image/slashpageHome/20250422/093800_lAwhgFFt1Qy122EcIj?q=80&s=1280x180&t=outside&f=webp)

만들어 둔 api 통합을 클릭하여 프라이빗 API 통합 시크릿 key를 복사 및 보관

![Image](https://upload.cafenono.com/image/slashpageHome/20250422/093800_wHZHBbbudrXFZCpFke?q=80&s=1280x180&t=outside&f=webp)

![Image](https://upload.cafenono.com/image/slashpageHome/20250422/093801_LPY02sDOzW6Vy6TZ5F?q=80&s=1280x180&t=outside&f=webp)

step3) Notion에서 Integration을 특정 데이터베이스와 페이지에 연결하여 권한을 부여

detail

 자동화 하려는 페이지에 접속하여 방금 발급 받은 api 통합을 클릭

![Image](https://upload.cafenono.com/image/slashpageHome/20250422/093802_XnfgwfFoexDuq6Gqh0?q=80&s=1280x180&t=outside&f=webp)

이제 n8n을 통해 노션 페이지를 자동화 할 준비를 마쳤습니다! 💪

이제부터 각 노드의 기능을 알아봅시다.

## 📌 Page 노드

## 개요

**Notion Node (Page)**는 n8n에서 Notion API를 활용하여 Notion의 페이지를 생성, 검색, 조회 및 삭제할 수 있도록 지원하는 노드입니다. 

이 노드를 활용하면 자동화된 워크플로우를 통해 Notion 페이지를 효율적으로 관리할 수 있습니다.

## 1. Create Page (페이지 생성)

### 기능

새로운 Notion 페이지를 생성합니다.

### 입력 (Input)

- **pageId**: 부모 페이지 또는 데이터베이스의 URL (필수)

- **title**: 생성할 페이지의 제목 (필수)

- **simple**: 단순 출력 여부 (선택)

- **options**: 추가 설정 (선택)

### 출력 (Output)

- 생성된 Notion 페이지의 ID

- 생성된 페이지의 URL

- 기타 관련 메타데이터 (생성 시간, 수정 시간 등)

## 2. Search Page (페이지 검색)

### 기능

특정 키워드를 포함하는 Notion 페이지를 검색합니다.

### 입력 (Input)

- **operation**: `"search"` (필수)

- **text**: 검색할 텍스트 (필수)

- **simple**: 단순 출력 여부 (선택)

- **options**: 추가 설정 (선택)

### 출력 (Output)

- 검색된 페이지 목록

- 각 페이지의 ID, 제목, URL 및 기타 메타데이터

## 3. Get Page (페이지 정보 가져오기)

### 기능

특정 Notion 페이지의 상세 정보를 가져옵니다.

### 입력 (Input)

- **operation**: `"get"` (필수)

- **pageId**: 가져올 Notion 페이지의 ID 또는 URL (필수)

- **simple**: 단순 출력 여부 (선택)

### 출력 (Output)

- 해당 페이지의 제목, 내용, 생성일, 수정일 등 상세 정보

## 4. Archive Page (페이지 삭제)

### 기능

기존 Notion 페이지를 아카이브(삭제)합니다.

### 입력 (Input)

- **operation**: `"archive"` (필수)

- **pageId**: 삭제할 페이지의 ID 또는 URL (필수)

- **simple**: 단순 출력 여부 (선택)

### 출력 (Output)

- 아카이브된 페이지의 ID 및 상태 정보

## 📌 Database 노드

## 개요

Notion Node (Database)는 n8n에서 Notion API를 활용하여 Notion의 데이터베이스 정보를 조회하고 검색할 수 있도록 지원하는 노드입니다. 

이 노드를 사용하면 Notion의 데이터베이스 목록을 검색하거나 특정 데이터베이스 정보를 가져올 수 있습니다.

## 1. Get Database (데이터베이스 정보 가져오기)

### 기능

특정 Notion 데이터베이스의 정보를 가져옵니다.

### 입력 (Input)

- **resource**: `"database"` (필수)

- **databaseId**: 가져올 데이터베이스의 ID 또는 URL (필수)

### 출력 (Output)

- 데이터베이스 ID, 제목, 생성일, 수정일

- 속성 목록 (컬럼 정보)

- 기타 메타데이터

## 2. Get Many Database (모든 데이터베이스 목록 조회)

### 기능

현재 존재하는 모든 데이터베이스 목록을 조회합니다.

### 입력 (Input)

- **resource**: `"database"` (필수)

- **operation**: `"getAll"` (필수)

### 출력 (Output)

- 존재하는 모든 데이터베이스 목록

- 각 데이터베이스의 ID, 제목, 생성일, 수정일, 속성 목록 등

## 3. Search Database (데이터베이스 검색)

### 기능

특정 키워드를 포함하는 데이터베이스를 검색합니다.

### 입력 (Input)

- **resource**: `"database"` (필수)

- **operation**: `"search"` (필수)

- **text**: 검색할 텍스트 (필수)

- **options**: 추가 설정 (선택)

### 출력 (Output)

- 검색된 데이터베이스 목록

- 각 데이터베이스의 ID, 제목, URL 및 기타 메타데이터

## 📌 User 노드

## 개요

Notion Node (User)는 n8n에서 Notion API를 활용하여 특정 사용자의 정보를 조회하거나, 워크스페이스 내의 모든 사용자 목록을 가져올 수 있도록 지원하는 노드입니다.

 이 노드를 활용하면 Notion의 사용자 정보를 자동화된 방식으로 관리할 수 있습니다.

## 1. Get User (특정 사용자 정보 가져오기)

### 기능

특정 Notion 사용자의 정보를 가져옵니다.

### 입력 (Input)

- **resource**: `"user"` (필수)

- **userId**: 가져올 사용자의 ID (필수)

### 출력 (Output)

- 사용자의 ID, 이름, 이메일

- 프로필 이미지 URL (avatar_url)

- 사용자 유형 (개인 또는 봇)

## 2. Get Many User (모든 사용자 목록 조회)

### 기능

Notion 워크스페이스 내의 모든 사용자의 정보를 가져옵니다.

### 입력 (Input)

- **resource**: `"user"` (필수)

- **operation**: `"getAll"` (필수)

### 출력 (Output)

- 워크스페이스 내 모든 사용자 목록

- 각 사용자의 ID, 이름, 이메일, 프로필 이미지 URL

- 사용자 유형 (개인 또는 봇)

## 📌 Block 노드

## 개요

Notion Node (Block)는 n8n을 통해 Notion 페이지 내에 블록(Block)을 추가하거나, 특정 페이지의 블록 목록을 조회하는 기능을 제공합니다. 

이를 통해 Notion 페이지의 내용을 자동화하여 구성할 수 있습니다.

## 1. Append Block (블록 추가)

### 기능

특정 Notion 페이지 내에 새로운 블록을 추가합니다.

### 입력 (Input)

- **resource**: `"block"` (필수)

- **blockId**: 블록을 추가할 페이지 또는 블록의 ID 또는 URL (필수)

- **blockUi.blockValues**: 추가할 블록의 유형과 내용 (필수)

    - `type`: 블록의 유형 (예: `"heading_1"`, `"paragraph"`, `"bulleted_list_item"` 등)

    - `textContent`: 블록의 텍스트 내용

### 출력 (Output)

- 생성된 블록의 ID, 유형, 생성 시간, 수정 시간

- 블록을 생성한 사용자 정보

## 2. Get Block (블록 목록 가져오기)

### 기능

특정 Notion 페이지 내에 존재하는 블록들의 목록을 조회합니다.

### 입력 (Input)

- **resource**: `"block"` (필수)

- **operation**: `"getAll"` (필수)

- **blockId**: 블록 목록을 조회할 페이지 또는 블록의 ID 또는 URL (필수)

### 출력 (Output)

- 해당 페이지 내 존재하는 모든 블록 목록

- 블록의 ID, 유형, 생성일, 수정일

- 블록의 내용 및 기타 메타데이터

> Notion API Docs기반으로 작동합니다.

[https://developers.notion.com/docs/getting-started](https://developers.notion.com/docs/getting-started) 

[https://slashpage.com/n8n-guide/93nzyxmdxr44rmwk6r45](https://slashpage.com/n8n-guide/93nzyxmdxr44rmwk6r45)

[https://slashpage.com/n8n-guide/xjqy1g2vd6qqr26vd54z](https://slashpage.com/n8n-guide/xjqy1g2vd6qqr26vd54z)

For the site tree, see the [root Markdown](https://slashpage.com/n8n-guide.md).