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
  1. In Admin Center, click Apps and integrations in the sidebar, then select Actions > Action flows.
  2. Create or edit an action flow.
  3. Open the step sidebar.
  4. Under External actions, click Notion.
  5. Click Connect.
  6. 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.
Powered by Zendesk