# List Notion items

URL: /en/docs/api/v1/integrations/notion/post
Last Updated: 2026-07-30T21:15:30.134Z

## Description
No description available.

## Available Actions
- Execute POST request
- View request parameters
- View response schema
- Get code examples
- Navigate to related topics
- View step-by-step instructions
- Get best practices

## Content
### POST /api/v1/integrations/notion

**List Notion items**

Lists Notion pages and databases from search results or from the children of a specific parent page/database. Emits eventName `integrations.notion.fetch_items` and failureEventName `integrations.notion.fetch_items_failed`.

**Authentication:** Bearer token (`Authorization: Bearer <token>`)

**Request body** (`application/json`):

- `providerConfigKey` (string)
- `connectionId` (string)
- `parentId` (string)
- `parentType` (enum: database | page)
- `includePages` (boolean)
- `includeDatabases` (boolean)
- `pageToken` (string)
- `search` (string)

**Responses:**

- `200` - Notion items loaded
  - `success` (enum: true, required)
  - `data` (object, required)
    - `items` (array of NotionItem (object), required)
      - `id` (string, required)
      - `object` (enum: page | database, required)
      - `title` (string, required)
      - `dataSourceId` (string): First Notion data source id for database items.
      - `url` (string, required)
      - `lastEditedTime` (string, required)
      - `icon` (string, required)
      - `hasChildren` (boolean, required)
      - `parent` (object, required)
        - `type` (string, required)
        - `id` (string, required)
    - `nextPageToken` (string)
- `400` - Bad request
  - `error` (string, required): Error message or stable error code.
  - `code` (string)
  - `data` (object)
- `401` - Unauthorized
- `403` - Forbidden - Admin or Content Manager role required
  - `error` (string, required): Error message or stable error code.
  - `code` (string)
  - `data` (object)
- `404` - Notion integration not found
  - `error` (string, required): Error message or stable error code.
  - `code` (string)
  - `data` (object)
- `500` - Internal server error
  - `error` (string, required): Error message or stable error code.
  - `code` (string)
  - `data` (object)
  - `error` (enum: notion_fetch_failed, required)
- `default` - Notion provider fetch failed
  - `error` (enum: notion_fetch_failed, required)