Pontx HubAPI reference for humans & agents

Notion / Productivity

Notion collaborative workspace API

Manage pages, blocks, data sources/databases, comments, file uploads, views, users, and search through the official versioned Notion API, with OAuth and async tasks. The complete boundary is the 49 endpoints in the official OpenAPI snapshot; workspace data is private user content, so Pontx does not proxy, cache, or aggregate it and callers use the local SDK/CLI directly.

Browse all endpointsPreview requestInstall product Skill
Provider
Notion
Authentication
bearer / basic
Endpoints
49
Schemas
523
Live calls
Unavailable
SDK
v0.1.2
Request previewThis endpoint is not available for interactive debugging
Task
Open selected endpoint

Authentication

Set up credentials and authorization for this browser session before debugging the request.

  1. As a Workspace Owner, create an Internal connection in the Notion Creator Dashboard.

  2. Copy its installation access token from Configuration and grant only the minimum capabilities required.

  3. Share each required page with the connection through Add connections, then keep the token only in NOTION_ACCESS_TOKEN.

  1. Create a Public connection in the Notion Creator Dashboard and configure its installation scope, redirect URI, and least-privilege capabilities.

  2. Copy the OAuth Client ID and Client Secret from Configuration and store them only on your server.

  3. Have the user authorize the connection, then exchange the code with HTTP Basic on your server. Never expose the Client Secret to a browser.

GET /v1/users/me

Get current connection identity

Returns the connection (bot or user) that owns the current access token; personal access tokens resolve to the user who created them.