Database

Database is a Notion component for working with Notion databases: it lists the ones you have, shows the properties (columns) of one of them and creates new databases inside a page.

When to use it

• Knowing which columns a Notion database has before creating pages in it.
• Creating a new database for a project.
• Giving an agent the list of available databases.

Configuration

The Operation field decides what the component does: List (default) lists your databases, List Properties shows one’s properties and Create creates a new one.

You need a Notion API credential with your Notion integration token. See Credentials.

Field	What it does
Credential (required)	The Notion API credential.
Operation	What the component does.
Database Input Type	With List Properties, how you point to the database: Select Database (default, from a list) or Id.
Database ID	With List Properties, the database.
Max Results	With List, how many databases are returned. Default: 50.
Parent Page Input Type	With Create, how you point to the page where it is created: Id (default) or Url.
Parent Page ID	With Create, the page where the database is created.
Database Title	With Create, the new database’s title.
Properties Database	With Create, the database’s column types, such as rich_text, number, select, date, email or status.

Note

Your Notion integration only sees the pages and databases you have shared with it from Notion.

Output

The Data output holds the databases, their properties or the database created.

In tool mode, an agent can use the component by itself. See Tool Mode.

Example

Before logging incidents in Notion, a flow checks the database’s columns.

1. Add Database with List Properties and choose the “Incidents” database.
2. Pass Data to an agent that fills each column correctly with Page.

Related components

• Page: creates and updates Notion pages.