Notion Integration Token과 Database ID는 어디서 가져오나

Notion을 외부 도구와 연결하려면 Integration Token이 필요합니다.

OAuth가 아닌 날것의 토큰 방식을 쓰려면, 토큰 발급뿐 아니라 페이지에 대한 접근 권한까지 직접 연결해야 합니다. 이 글은 그 전 과정을 단계별로 정리합니다.

필요한 값 두 가지

Notion API를 쓰려면 다음이 필요합니다.

• Integration Token: API 호출용 키입니다.
• Database ID: 읽고 쓸 대상 데이터베이스의 식별자입니다.

둘 다 직접 챙겨야 합니다.

Integration Token 발급하기

1. Notion Integrations 페이지로 갑니다.
2. New integration을 누릅니다.
3. 이름을 입력하고, 연결할 workspace를 선택합니다.
4. Type은 Internal로 둡니다. Public은 OAuth 앱을 만들 때 사용합니다.
5. 생성 후 Secrets 탭에서 Show를 누르고 토큰을 복사합니다.

이 토큰이 API 호출에 쓰일 Authorization: Bearer 값입니다.

페이지에 연결 권한 주기

Notion은 토큰만으로 모든 페이지에 접근할 수 있게 하지 않습니다. 연결할 페이지마다 권한을 줘야 합니다.

1. 대상 페이지나 데이터베이스를 엽니다.
2. 우측 상단 ... 메뉴를 누릅니다.
3. Connections → 방금 만든 integration 이름을 선택합니다.
4. Confirm을 누릅니다.

이 단계를 빼먹으면 API에서 404가 뜹니다. 토큰은 맞는데 권한이 없는 상황입니다.

Database ID 뽑기

데이터베이스 URL에서 ID를 추출합니다.

URL은 보통 다음 둘 중 하나입니다.

• https://www.notion.so/workspace/abcdefgh12345678?v=...
• https://www.notion.so/abcdefgh12345678?v=...

여기서 abcdefgh12345678 부분이 Database ID입니다. 하이픈이 붙은 긴 ID 형태일 때도 있는데, 그 경우 URL 마지막 32자를 사용하면 됩니다.

정리하면

단계	위치	주의
Token 발급	my-integrations	Internal 선택, Public은 OAuth 별도
권한 연결	페이지/DB ... → Connections	안 하면 404
DB ID 추출	URL의 마지막 32자	하이픈 제거 주의

자주 걸리는 함정

가장 흔한 실수는 토큰은 발급받고 페이지 연결은 안 하는 경우입니다. Notion API는 workspace 전체가 아니라 명시적으로 연결된 페이지만 볼 수 있도록 설계되어 있습니다.

또한 Integration Type을 Public으로 만들었다가 OAuth redirect URI 설정이 복잡해지는 경우도 있습니다. 내용 워크스페이스 자동화라면 Internal로 충분합니다.

마지막으로 Database ID를 복사할 때 URL의 ?v= 앞부분만 잘라야 합니다. v= 파라미터 뒤는 view ID이므로 데이터베이스 ID가 아닙니다.