Add docs for new Notion tool (#356)

Add docs for Notion tool

Author: EricGustin

pages/toolkits/productivity/notion.mdx

@@ -38,6 +38,7 @@ These tools are currently available in the Arcade Notion toolkit.
     ["NotionToolkit.SearchByTitle", "Search for pages or databases by title."],
     ["NotionToolkit.GetObjectMetadata", "Get the metadata of a Notion object (page or database) using its title or ID."],
     ["NotionToolkit.GetWorkspaceStructure", "Get the complete workspace structure of your Notion workspace."],
+    ["NotionToolkit.AppendContentToEndOfPage", "Append content to the end of a Notion page."],
   ]}
 />
 
@@ -213,6 +214,32 @@ Get the complete workspace structure of your Notion workspace. This tool returns
 
 _None_
 
+---
+
+## NotionToolkit.AppendContentToEndOfPage
+
+<br />
+<TabbedCodeBlock
+  tabs={[
+    {
+      label: "Call the tool with user authorization",
+      content: {
+        Python: [
+          "/examples/integrations/toolkits/notion/append_content_to_end_of_page.py",
+        ],
+        JavaScript: ["/examples/integrations/toolkits/notion/append_content_to_end_of_page.js"],
+      },
+    }
+  ]}
+/>
+
+Append markdown content to the end of a Notion page using either the page's ID or title.
+
+**Parameters**
+
+- **`page_id_or_title`** _(string, required)_ The ID or title of the page to append content to.
+- **`content`** _(string, required)_ The markdown content to append to the end of the page.
+
 ## Auth
 
 The Arcade Notion toolkit uses the [Notion auth provider](/home/auth-providers/notion) to connect to users' Notion accounts.
@@ -221,4 +248,4 @@ With the hosted Arcade Engine, there's nothing to configure. Your users will see
 
 With a self-hosted installation of Arcade, you need to [configure the Notion auth provider](/home/auth-providers/notion#configuring-notion-auth) with your own Notion app credentials.
 
-<ToolFooter pipPackageName="arcade_notion_toolkit" />
+<ToolFooter pipPackageName="arcade_notion_toolkit" />

public/examples/integrations/toolkits/notion/append_content_to_end_of_page.js

@@ -0,0 +1,32 @@
+import { Arcade } from "@arcadeai/arcadejs";
+
+const client = new Arcade(); // Automatically finds the `ARCADE_API_KEY` env variable
+
+const USER_ID = "{arcade_user_id}";
+const TOOL_NAME = "NotionToolkit.AppendContentToEndOfPage";
+
+// Start the authorization process
+const authResponse = await client.tools.authorize({
+  tool_name: TOOL_NAME,
+  user_id: USER_ID,
+});
+
+if (authResponse.status !== "completed") {
+  console.log(`Click this link to authorize: ${authResponse.url}`);
+}
+
+// Wait for the authorization to complete
+await client.auth.waitForCompletion(authResponse);
+
+const toolInput = {
+  page_id_or_title: "YOUR_PAGE_ID_OR_TITLE",
+  content: "P.S. Never forget that you are a wizard."
+};
+
+const response = await client.tools.execute({
+  tool_name: TOOL_NAME,
+  input: toolInput,
+  user_id: USER_ID,
+});
+
+console.log(response);

public/examples/integrations/toolkits/notion/append_content_to_end_of_page.py

@@ -0,0 +1,29 @@
+from arcadepy import Arcade
+
+client = Arcade()  # Automatically finds the `ARCADE_API_KEY` env variable
+
+USER_ID = "{arcade_user_id}"
+TOOL_NAME = "NotionToolkit.AppendContentToEndOfPage"
+
+auth_response = client.tools.authorize(
+    tool_name=TOOL_NAME,
+    user_id=USER_ID,
+)
+
+if auth_response.status != "completed":
+    print(f"Click this link to authorize: {auth_response.url}")
+
+# Wait for the authorization to complete
+client.auth.wait_for_completion(auth_response)
+
+tool_input = {
+    "page_id_or_title": "YOUR_PAGE_ID_OR_TITLE",
+    "content": "P.S. Never forget that you are a wizard."
+}
+
+response = client.tools.execute(
+    tool_name=TOOL_NAME,
+    input=tool_input,
+    user_id=USER_ID,
+)
+print(response)