Notion
The Notion integration lets Helios agents search the Notion API and call any endpoint to create pages, update database entries, query data, search content, and comment.
What your agents can do
Agents don't pick from a preset list of actions. They semantically search the entire Notion API and call whatever endpoint a task needs, using your connected credentials. There is no fixed set of operations to choose from.
- Create pages and add rows to databases
- Update page properties and content
- Query databases with complex filters and sorts
- Read and append blocks (text, headings, to-dos, images, code, and more)
- Search the workspace to locate pages or databases
- Read and add comments on pages
Authentication
| Method | Type | Description |
|---|---|---|
| Helios Notion app (recommended) | OAuth 2.0 | Full-featured integration for all workspaces |
| Internal integration | Secret Token | Workspace-specific integration with a token |
| BYO Notion app | OAuth 2.0 | Custom public integration for advanced control |
Helios Notion app (recommended)
The Helios Notion app is a full-featured integration that can access any Notion workspace. Connecting runs the Notion OAuth redirect flow.
It requests permission to:
- Read, update, and insert content
- Read and insert comments
- Read user information, including email addresses
Internal integration
An internal integration only has access to the workspace it is created in, and can be used with a token instead of the OAuth flow.
- Go to notion.so/my-integrations and create a new internal integration
- Copy the integration's Internal Integration Token
- Paste the token into the Notion credential in Helios
- In Notion, share each page or database you want Helios to access with the integration
Learn more about internal integrations in the Notion documentation.
BYO Notion app
If you want more granular control, create your own public OAuth app in Notion and supply its client ID, client secret, access token, and refresh token to Helios. This requires additional setup and is not recommended for most users.
Learn more about public integrations in the Notion documentation.
Triggers
Notion does not currently emit event triggers into Helios. Use it from Chat, or from a Workflow driven by a schedule, webhook, or manual run.
Notes
An agent can only reach pages and databases that have been explicitly shared with the integration. If an agent reports that it cannot find a page, share that page with the integration in Notion and try again.
See the full endpoint list in the Notion API reference.
Last updated on
Plain
The Plain integration lets Helios agents query and mutate your Plain workspace through its GraphQL API, and run agents automatically when customer threads are created.
Attio
The Attio integration lets Helios agents manage CRM records, run sales processes, track interactions, and sync data with Attio's customizable platform directly.