Notion

Updated May 14, 2026 · FinityAi

Notion is your team's wiki, tasks, and databases in one workspace. In FinityAi, you connect it with Sign in with Notion (recommended) or a manual integration token so the assistant can call the Notion API on your behalf. FinityAi only sees content you have explicitly shared with your integration in Notion— private pages stay private until you invite the integration.

What you need in Notion

A Notion account with access to the workspace you want the assistant to work in.
An internal integration (or OAuth app) in Notion with the capabilities you need—at minimum, read content you plan to open; add insert/update capabilities if you want the assistant to create or edit pages, databases, blocks, or comments. Notion's docs explain each capability—see Create a Notion integration.
For manual tokens: copy the secret from My integrations → your integration → Secrets. Tokens typically start with secret_ or ntn_ depending on how Notion issued them.

Connect in FinityAi

Sign in to FinityAi, open Integrations, and turn Notion on using the card switch. You can return anytime to turn access off without deleting your saved connection details.
Open Integrations → Notion. Use Connect with Notion when that option is available for your workspace, or expand Use manual token and paste your integration secret, then save.
In Notion, open each page or database you want FinityAi to use, click ⋯ (or Share), and invite your integration. Without this step, search and reads return nothing or 404-style errors for those items.
Use Disconnect in FinityAi when you want to remove the stored token from our side; rotate the secret in Notion if it was exposed.

Notion's API is capability-based and object-scoped: your integration must be invited to each top-level page or database (child pages inherit access from parents in line with Notion's rules). If the assistant cannot find a page, the first check is whether the integration appears in that page's share dialog.

Databases: share the database itself so row queries and reading the column layout work.
Comments: enable read and insert comment capabilities on the integration in Notion; the API only surfaces unresolved threads in list responses.
Creating databases: requires insert permissions; pick a parent page the integration can already open.

Assistant: enable tools

Notion actions run only when the assistant is allowed to use tools.

Open the Assistant.
In the header, open Settings and ensure connected apps and tools are enabled so integrations can invoke tool calls.
Ask in natural language. If nothing happens, confirm the Notion card on Integrations is on, your connection is saved, and the page or database is shared with your integration in Notion.

New to chat settings? See the Assistant user guide.

What the assistant can do

When Tools are on, the assistant can take the kinds of actions below. You describe what you want in everyday language—you never need to type internal names or technical field labels.

Search

Find pages by title, or browse everything this integration is allowed to see. You can ask for only pages, only databases, or both. Long lists may come in batches—the assistant can keep going if there's more to load.

Pages and databases

Open a page to see its details and properties. Open a database to see its columns. Create a new page under another page or as a new row inside a database. Update a page's fields or archive it when you ask. Create a new database under a page you can access, with whatever columns you need. Query a database with filters and sorting, and move through results in pages when the table is large.

Blocks

Read the blocks on a page layer by layer (for top-level content, that usually means starting from the page itself). Open one block, change it, or remove it—removing a block can't be undone. Add new content under a page in chunks; very large pastes are split so each step stays within safe size limits.

People

List people in the workspace and open someone's profile when your integration and workspace settings allow it.

Comments

List open comment threads on a page or block when reading comments is allowed. Add a new comment or reply in an existing thread when your integration allows it. Notion decides what counts as a page comment versus an inline discussion—the assistant follows those rules.

Sample prompts

Swap in your own page titles and dates. If the assistant needs to find something by name, ask it to search your workspace first.

“Search my Notion workspace for pages about Q1 planning—list titles and ids.”
“Run an empty Notion search and show the first 20 shared pages and databases with their ids.”
“Get the database schema for my Tasks database (I’ll paste the id from the URL).”
“Query my Projects database for rows where Status is In progress, newest first, page size 25.”
“Open this Notion page by id and summarize the title and properties.”
“List the top-level blocks on this page, then fetch the text of the first heading and first paragraph.”
“Append a short bulleted list under this page id with three next steps.”
“Create a new page titled ‘Meeting notes — April 10’ under this parent page id.”
“Update this Notion page: set the Due date property to next Friday and leave other properties unchanged.”
“List unresolved comment threads on this page id; then add a reply in the first thread.”
“List people in my workspace (first page), then show details for one user id from the list.”
“Archive this block id (confirm first)—I’m cleaning up a duplicate paragraph.”
“Create a simple inline database under this parent page titled ‘Leads’ with columns Name (title) and Status (select).”

Pointing at the right page or database

Notion web addresses hide a long identifier for each page and database—often with dashes in the middle. You can copy it from the browser bar, or ask the assistant to search and read it from the results.
For reading or editing what's on a page, the same identifier usually works for “the page itself” and for the first layer of content underneath it.
To filter or sort rows in a table, point at the main database—not only a filtered view of it—using search or the URL from when the database is open on its own.

Pagination, blocks, and size

Long lists and big tables come back in chunks (up to about a hundred rows or items at a time). Ask for the next chunk if the assistant says there's more.
Pasting a lot of structure onto a page at once is also done in chunks—each step stays within a safe size.
Very large answers may be shortened for safety; ask for a narrower date range, fewer rows, or the next chunk explicitly.

Privacy and your token

Your token is stored for your account so the hosted assistant can call Notion. Treat it as a secret: revoke and reissue in Notion if it leaks.
FinityAi only accesses objects your integration can access—Notion enforces capabilities and sharing.

If something fails

401 / unauthorized — Token invalid or revoked. Generate a new secret in Notion or reconnect via OAuth, then save again under Integrations → Notion.
403 / forbidden — Missing capability (e.g. comments) or the page is not shared with the integration. Open the page in Notion and add the integration under Share.
404 / object not found — Wrong address, deleted item, or no access. Double-check the link or ask the assistant to search your workspace for the right page.
Tools never run — Enable Notion on Integrations, enable tools in the assistant, and confirm status shows the secret saved and accepted.
Empty search — Nothing is shared with the integration yet, or capabilities block listing. Share at least one page and retry.

Official Notion docs

Use these for capabilities, token lifecycle, and API details outside FinityAi.

Create a Notion integrationCapabilities, secrets, and workspace access model.
Getting started with the Notion APIFirst requests, versioning headers, and core concepts.
Notion API referenceEndpoint reference for search, pages, databases, blocks, comments, and users.

← All documentation