ページを作成
POST
/v1/pages
properties
body パラメータ で有効なプロパティは title
だけです 。properties
オブジェクトの body パラメータのキーは、 親 データベースのプロパティと一致する必要があります。children
オプションを使用して、コンテンツの有無にかかわらず新しいページを作成するために使用できます。作成後にページにコンテンツを追加するには、Append block childrenエンドポイントを使用します。🚧一部のページ
properties
はAPI 経由でサポートされていません。プロパティ オブジェクトに rollup
、created_by
、created_time
、last_edited_by
、またはlast_edited_time
値を含む要求本文は、エラーを返します。これらの Notion によって生成された値は、API を介して作成または更新することはできません。parent
にこれらのプロパティのいずれかが含まれている場合、新しいページの対応する値が自動的に作成されます。
📘要件
このエンドポイントを呼び出すには、統合にターゲットの親ページまたはデータベースのコンテンツ更新機能が必要です。統合機能を更新するには、[マイインテグレーション]ダッシュボードに移動し、統合を選択して**[機能]**タブに移動し、必要に応じて設定を更新します。 コンテンツ更新機能なしでクエリを試行すると、403 ステータス コードを含む HTTP 応答が返されます。
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://api.notion.com/v1/pages' \
--header 'Notion-Version;' \
--header 'Content-Type: application/json' \
--data-raw ''
Response Response Example
200 - 成功例
{
"object": "page",
"id": "59833787-2cf9-4fdf-8782-e53db20768a5",
"created_time": "2022-03-01T19:05:00.000Z",
"last_edited_time": "2022-07-06T19:16:00.000Z",
"created_by": {
"object": "user",
"id": "ee5f0f84-409a-440f-983a-a5315961c6e4"
},
"last_edited_by": {
"object": "user",
"id": "ee5f0f84-409a-440f-983a-a5315961c6e4"
},
"cover": {
"type": "external",
"external": {
"url": "https://upload.wikimedia.org/wikipedia/commons/6/62/Tuscankale.jpg"
}
},
"icon": {
"type": "emoji",
"emoji": "🥬"
},
"parent": {
"type": "database_id",
"database_id": "d9824bdc-8445-4327-be8b-5b47500af6ce"
},
"archived": false,
"properties": {
"Store availability": {
"id": "%3AUPp"
},
"Food group": {
"id": "A%40Hk"
},
"Price": {
"id": "BJXS"
},
"Responsible Person": {
"id": "Iowm"
},
"Last ordered": {
"id": "Jsfb"
},
"Cost of next trip": {
"id": "WOd%3B"
},
"Recipes": {
"id": "YfIu"
},
"Description": {
"id": "_Tc_"
},
"In stock": {
"id": "%60%5Bq%3F"
},
"Number of meals": {
"id": "zag~"
},
"Photo": {
"id": "%7DF_L"
},
"Name": {
"id": "title"
}
},
"url": "https://www.notion.so/Tuscan-Kale-598337872cf94fdf8782e53db20768a5"
}
Requestパラメータ
Headerパラメータ
Notion-Version
string
必須
Request Bodyパラメータapplication/json
Response
更新日時 2023-04-28 10:38:59