Create a Page

In Tonkean, navigate to your Notion data source and select Actions in the data source configuration panel. The Actions screen displays.

Select Create New Custom Action in the upper right. The New HTTP Custom Action window displays.

In the The action will be field, select the first dropdown and select Creating, then select the second dropdown and select Page. When finished, select Create. The window closes and the Custom Action General screen displays.

Enter a unique Display Name for the action. This is the title of the action that displays to other makers.

In the Settings panel, select Request. The Request screen displays.

In the Path field, ensure the method dropdown is set to POST, then enter the endpoint URL: v1/pages.

In the Body field, enter the request body with all required fields.

{
    "parent": {
       "database_id": ""
   },
   "properties": {
       "title": {
           "title": [
               {
                   "type": "text",
                   "text": {
                       "content": ""
                   }
               }
           ]
       }
   },
   "children": [
       {
           "object": "block",
           "type": "heading_2",
           "heading_2": {
               "rich_text": [
                   {
                       "type": "text",
                       "text": {
                           "content": ""
                       }
                   }
               ]
           }
       }
   ]
}

For each required dynamic value, create a new param and include it in the body. For this action, Parent ID, Page Title, and Block Header are all dynamic values you must create pararms for.

To create a param, follow the steps below:

When finished, the Body field should appear as in the image below, with the appropriate params included:

In the Headers section, select + Add Header. A new Header Name and Header Value fields display.

Enter the following values:

Select Test Request. The Test Action window displays.

Enter values for each action param:

Select Run Test. The request runs with the param values you provided and the Response section populates, including a notification with the HTTP response code. The Response Body and Headers tabs in the Response section display the response from the endpoint.

If the test is successful, a 200 Success response code displays.

If you don't receive the expected response, or your test request fails, close the Test Action window and return to the Request screen to troubleshoot the problem.

Some common errors with Notion custom actions are caused by a particular entity not being shared with Tonkean. In Notion, navigate to the relevant entity (in this case, a database page) and select Share in the upper right. Ensure the Tonkean integration has edit permissions.

If the test is successful and you receive the response you expect, close the Test Action window and select Save Action Changes in the upper right of the Request screen.

In the Settings panel, select Response Handling. The Response Handling screen displays, including the response you received in your previous test.

In the Response Body tab, locate and select the id key-value pair. The location of the key-value pair displays in the JSON Path field below the body.

Select Copy to copy the path, then paste the path into the Pages ID field.

When finished, select Save Action Changes in the upper right.