Notion
using the notion app in charthop the notion app connects your notion workspace to charthop so the information your team keeps in notion is available alongside your people data this guide covers how to connect notion, how the app behaves once connected, and what to know if you want to build your own notion app instead of using charthop's 1\ choose a connection type you can connect notion to charthop in two ways pick the one that matches how your organization uses notion individual user connection each person authorizes charthop against their own notion account charthop respects the access level that a user already has in notion if you can't see a page in notion, you won't see it through charthop either use this option when access to notion content varies from person to person and you want those permissions enforced shared organization connection one connection is set up for the whole organization, scoped to the notion content your team has agreed to share this makes shared information (team wikis, process docs, org wide pages) available in charthop without provisioning a notion seat or connection for every user use this option when you want broad access to shared content without managing individual authorizations which should you pick? if your notion permissions matter (sensitive pages, restricted teamspaces), use individual user connections if you mainly want company wide content accessible to everyone in charthop, use the shared organization connection 2\ installing the app go to apps, bundles and agents → apps → other available apps and open notion click install to start the process provide your oauth credentials field required notes client id yes from your notion integration settings client secret yes from your notion integration settings store it only in the app definition; never share it elsewhere token url yes, always from your notion integration settings this is the endpoint charthop uses to exchange and refresh tokens authorization url during user authorization only from your notion integration settings used to send the user through notion's consent flow tip the token url and authorization url serve different steps authorization happens once per user; token exchange happens on an ongoing basis only the token url is permanent in your app definition 3\ how the app is configured configuration for this app is defined on the app level authentication how the app authenticates against notion (oauth credentials and token exchange) retries and rate limiting how the app handles notion's api limits and transient failures, so requests are retried automatically and you stay within notion's rate limits without manual intervention available operations the set of actions the app can perform (for example, reading pages, querying databases, searching content) pagination how the app pages through large result sets from notion so complete data is returned even when notion responds in batches entity mapping what each operation means on the charthop side, in other words, how notion objects (pages, databases, users) map back to charthop entities you don't need to configure any of this to use charthop's built in notion app; it's already defined
