NOTE: Notion integration requires Drafts v31 or greater. The Notion API used for integration is still in beta, as such aspects of this functionality may change or break and Notion finalizes their API.
Notion is an online project management and information system. Drafts currently two ways to integrate with Notion:
Notion script object: Provides a request method which allows you to script calls to the full Notion API, while providing automatic OAuth authenticate flow.The action step provides a basic, easy to approach way to get your data from Drafts to Notion. Scripting supports advanced integration, for users needing to work with databases and other block types in Notion.
Like most services Drafts integrates with, Notion uses the OAuth standard for authentication. The first time you use an action that integrates with Notion, you will be redirected to the Notion website and asked to log in and authorize Drafts to use your account.
When authenticating, Notion has an additional step of selecting specific pages in Notions which the integration will be granted permissions to access. It is recommended you give Drafts permissions only to the pages you plan to target with actions.
After you have authorized Drafts, you can add and remove page permissions in the Notion interface:
Permissions are inherited, so granting Drafts permission to access a page or workspace, gives it permission to access child elements of that item.
If “Drafts” does not appear as an option when to invite in your share page, make sure you have run a Notion action in Drafts and successfully authenticated to the correct workspace in Notion.
The Notion action step can add text or to-do lists to pages in Notion. Aspects of this step may change, but it’s a start. To get started, install an example action:
By default, these examples ask you to select a Notion page as a target each time they are run. They can also be configured to target a specific page by page ID. See next section on obtaining IDs, and the step documentation for further details on options available.
To configure action steps to target a specific page in Notion, you can use the “Select” button in the action step configuration, or obtain a specific Page ID from Notion.
To get a page ID:
Once you obtain that page ID, you can paste it in an action and change the action to “Assign” the target page.
Be sure the page you wish to target has been invited to the “Drafts” integration (see permissions section above) or the action will fail.
For advanced users, Drafts also provides a Notion Script object that allows you to make requests directly against the Notion API. Any API calls can be used, see Notion API docs for information on available methods. This object may add convenience methods for some functions, but right now only has a single request method that allows for arbitrary calls against the Notion API. Example action:
Notion stores text in its own structured block format. In their own apps and web version, they have tools that convert between Markdown pasted into the interface, and this native block format.
At this time, Notion has not added the ability to convert between this native block format and HTML or Markdown to the capabilities of the API.
It is possible to construct Notion blocks using JavaScript in Drafts (they are just complex JSON objects), and pass those values to the API, but due to the complexity of the format, we do not have any automated tools to do this conversion.
We are hoping Notion adds this capability before the API is final, and we will certain support it to provide a smoother way to pass Markdown and/or HTML to Notion if they do.
agiletortoise | 2022–02–16 16:37:02 UTC | #2
agiletortoise | 2022–02–25 12:44:59 UTC | #3
yacafx | 2022–02–26 22:40:55 UTC | #4
Looks like the link for https://scripting.getdrafts.com/classes/notion is not working… or maybe not published yet?
agiletortoise | 2022–02–26 22:46:52 UTC | #5
Oops, forgot to push the scripting reference updates. It’s there now.
yacafx | 2022–02–26 23:51:48 UTC | #6
U r the best! Thank u! 😃😃😃
nk141700 | 2022–02–27 04:17:32 UTC | #7
Good to see some Notion integrations!
After playing around with these options, I take it neither the “Create Page” or “Append as Text” action steps are capable of creating a new entry / page in a database?
Is that capability on the horizon?
sylumer | 2022–02–27 09:58:28 UTC | #8
In case it helps, it should be possible now - see “Using the Notion API in Script” above. It is just that you have to do some of the lifting rather than there being a prebuilt action to help.
If there’s a demand and use there for these options in particular, I wouldn’t be surprised if Greg built it into Drafts, or a Notion & Drafts user shared an action to do this based on scripting the interaction.
nk141700 | 2022–02–27 15:36:42 UTC | #9
Understood, thanks! I’ll give that a shot and see what I can come up with.