How to Get a Notion API Key

1. Create an Integration

   • Go to the Notion Developers Portal.
   • Click "New Integration", name it, select a workspace, and submit.

2. Get Your API Key

   • Copy the Internal Integration Token from the integration settings page.

3. Grant Database Access

   • Open your Notion database.
   • Click the three button dropdown at the top right of your screen, click Connections, and then select your integration.

4. Use the API Key

   • Add it to your Xano Actions in the Settings Registry input option:

For more details, see the Notion API Docs.

Notion → Page: Retrieve

Overview

This Xano action retrieves a page from Notion using its unique identifier (page_id). It uses the Notion API's GET method to fetch the page's details.

Inputs

Function Stack

1. Notion API Request

   • API Endpoint: https://api.notion.com/v1/pages/%s
   • HTTP Method: GET
   • Headers:
     • Authorization: Bearer <notion_api_key>
     • Notion-Version: 2022-06-28
   • Replace %s in the endpoint with the provided page_id

2. Precondition

   • Ensures that the HTTP request was successful
   • Condition: notion_api_response.status == 200
   • If this condition fails, execution halts and an error is thrown

Response

API Reference Example

Request

Example

Input

{
  "page_id": "9bc30ad4-9373-46a5-84ab-0a7845ee52e6"
}

Output

{
  "object": "page",
  "id": "59833787-2cf9-4fdf-8782-e53db20768a5",
  "created_time": "2022-07-06T19:52:00.000Z",
  "last_edited_time": "2022-07-06T19:52:00.000Z",
  "created_by": {
    "object": "user",
    "id": "0c3e9826-b8f7-4f73-927d-2caaf86f1103"
  },
  "last_edited_by": {
    "object": "user",
    "id": "ee5f0f84-409a-440f-983a-a5315961c6e4"
  },
  "cover": null,
  "icon": null,
  "parent": {
    "type": "database_id",
    "database_id": "d9824bdc-8445-4327-be8b-5b47500af6ce"
  },
  "archived": false,
  "properties": {
    "title": {
      "id": "title",
      "type": "title",
      "title": [
        {
          "type": "text",
          "text": {
            "content": "Example Page",
            "link": null
          },
          "annotations": {
            "bold": false,
            "italic": false,
            "strikethrough": false,
            "underline": false,
            "code": false,
            "color": "default"
          },
          "plain_text": "Example Page",
          "href": null
        }
      ]
    }
  },
  "url": "https://www.notion.so/Example-Page-59833787-2cf9-4fdf-8782-e53db20768a5"
}