Using Notion actions in action flows

Before you can include external actions in your action flows, you must connect the action builder to the external system.


What's my plan?







All Suites

Team, Growth, Professional, Enterprise, or Enterprise Plus










Support

Team, Professional, or Enterprise







Summary: ◀▼
You can connect action flows to Notion to automate tasks like creating, updating, and looking up pages, adding comments, and inserting content blocks. Use a dedicated service account for connections and review permissions carefully. These actions help integrate workflows across platforms, improving collaboration and content management within your support processes.




By connecting the action builder to external systems, such as Notion, admins
can integrate Zendesk with external systems in automated workflows, improving
collaboration and maintaining a seamless experience across multiple platforms.
Note: The steps associated with external systems in action flows are
referred to collectively as external actions.

This article contains the following topics:
Connecting Notion to action builder
Using Notion actions in action flows




Connecting Notion to action builder

Before you can include external actions in your action flows, you must connect the
action builder to the external system.
When connecting to external systems for use in action flows, the following best practices are recommended:
All external actions performed by an action flow are attributed to the user who connected the
external system. Therefore, it's a best practice to use a dedicated service
account rather than personal credentials when connecting to each external
system.
All integrations request access to necessary scopes. However, it's important that you review and validate the scopes before authorizing the connection to the external system.
When managing credentials for API key-based tools, such as OpenAI, it's best to store keys in a secure vault or credential manager.



To connect action builder to Notion
In Admin Center, click
Apps and integrations in the sidebar, then select Actions > Action
flows.

Create or edit an action flow.
Open the step sidebar.
Under External actions, click Notion.
Click Connect.
Follow Notion's prompts to authenticate and complete the connection. When
you authorize the connection, you'll be redirected to Notion to grant
permissions to your Zendesk account.
The Notion connection uses
OAuth 2.0 with the authorization code grant type. Review the permissions
carefully before authorizing the connection. These permissions allow
action flows to create and modify pages, add comments, manage database
items, and update content in your Notion workspace on your behalf.


Note: All external actions performed by an
action flow are attributed to the user who connected the external
system. Therefore, it is a best practice to use a dedicated service
account rather than personal credentials when connecting to each
external system.



After you've connected to the system, you'll see an indicator that it's connected and
details about the instance you're connected to, as well as the actions available for
Notion.



Using Notion actions in action flows

The following Notion actions are available:
Create page
Update page
Lookup page
Add comment
Add block to page




Creating a page

Use the Create page action to create a new page in Notion under a parent
page or at the workspace level.
This action has the following inputs and outputs:










Variables




Inputs
Required: Title Optional:
Parent page, Create at
workspace level,
Content
Either Parent page must
be specified or Create at workspace level must be set to
true. Workspace-level pages are only
available for public integrations. The Parent page field
allows searching your Notion pages by name.



Output
Page details including ID, URL, and creation
timestamp.








Updating a page

Use the Update page action to update an existing Notion page's title or
archive status.
Note: Archiving workspace-level pages is
not supported via the Notion API.

This action has the following inputs and outputs:










Variables




Inputs
Required: Page ID Optional:
Title,
Archived



Output
Page details including ID, URL, and last edited
timestamp.








Looking up a page

Use the Lookup page action to retrieve a Notion page by its ID or exact
title.
This action has the following inputs and outputs:










Variables




Inputs

Optional: Page ID,
Title
Either Page ID or Title is required. Provide one of these
fields to identify the page to retrieve.



Output
Page details including ID, URL, title, icon, creation
timestamp, last edited timestamp, and archived
status.








Adding a comment

Use the Add comment action to add a comment to a Notion page or block.
This action has the following inputs and outputs:










Variables




Inputs

Required: Page ID or Block ID,
Comment text
Either Page ID or Title is required. Provide one of these
fields to identify the page to retrieve.



Output
Comment ID, creation timestamp, and creator
information.








Adding a block to a page

Use the Add block to page action to add a content block (such as
paragraph, heading, or quote) to a Notion page.
This action has the following inputs and outputs:










Variables




Inputs

Optional: Page ID or Block
type, Content
Available block types include: Paragraph, Heading 1,
Heading 2, Heading 3, and Quote.



Output
Block ID, type, and creation timestamp.








{
"@context": "https://schema.org",
"@type": "TechArticle",
"@id": "https://support.zendesk.com/hc/en-us/articles/10831940580122-Using-Notion-actions-in-action-flows",
"url": "https://support.zendesk.com/hc/en-us/articles/10831940580122-Using-Notion-actions-in-action-flows",
"headline": "Using Notion actions in action flows",
"description": "You can connect an action builder to Notion to automate workflows by creating, updating, looking up pages, adding comments, and adding blocks within your Notion workspace through external actions.",
"articleSection": "Action builder and action flows",
"datePublished": "2026-05-27T21:15:34+00:00",
"dateModified": "2026-06-05T14:42:22.216829+00:00",
"inLanguage": "en-US",
"mainEntityOfPage": {
"@type": "WebPage",
"@id": "https://support.zendesk.com/hc/en-us/articles/10831940580122-Using-Notion-actions-in-action-flows"