[Hubspot] Updating Docs (#441)

* Adding new docs

* adding references

---------

Co-authored-by: Francisco Liberal <[email protected]>

Author: jottakka

pages/toolkits/sales/hubspot.mdx

@@ -0,0 +1,64 @@
+# Hubspot Reference
+
+Below is a reference of enumerations used by some of the tools in the Hubspot toolkit:
+
+## HubspotCallDirection
+
+- **INBOUND**: `INBOUND`
+- **OUTBOUND**: `OUTBOUND`
+
+## HubspotEmailDirection
+
+- **EMAIL**: `EMAIL`
+- **INCOMING_EMAIL**: `INCOMING_EMAIL`
+- **FORWARDED_EMAIL**: `FORWARDED_EMAIL`
+
+## HubspotEmailStatus
+
+- **BOUNCED**: `BOUNCED`
+- **FAILED**: `FAILED`
+- **SCHEDULED**: `SCHEDULED`
+- **SENDING**: `SENDING`
+- **SENT**: `SENT`
+
+## HubspotMeetingOutcome
+
+- **SCHEDULED**: `SCHEDULED`
+- **COMPLETED**: `COMPLETED`
+- **RESCHEDULED**: `RESCHEDULED`
+- **NO_SHOW**: `NO_SHOW`
+- **CANCELED**: `CANCELED`
+
+## HubspotCommunicationChannel
+
+- **SMS**: `SMS`
+- **WHATS_APP**: `WHATS_APP`
+- **LINKEDIN_MESSAGE**: `LINKEDIN_MESSAGE`
+- **PHYSICAL_MAIL**: `PHYSICAL_MAIL`
+- **CUSTOM_CHANNEL_CONVERSATION**: `CUSTOM_CHANNEL_CONVERSATION`
+
+## HubspotActivityType
+
+- **NOTE**: `note`
+- **CALL**: `call`
+- **EMAIL**: `email`
+- **MEETING**: `meeting`
+- **TASK**: `task`
+- **COMMUNICATION**: `communication`
+
+## HubspotSortOrder
+
+- **LATEST_MODIFIED**: `LATEST_MODIFIED`
+- **OLDEST_MODIFIED**: `OLDEST_MODIFIED`
+- **ALPHABETICAL**: `ALPHABETICAL`
+
+## HubspotDealType
+
+- **NEW_BUSINESS**: `newbusiness`
+- **EXISTING_BUSINESS**: `existingbusiness`
+
+## HubspotDealPriority
+
+- **LOW**: `low`
+- **MEDIUM**: `medium`
+- **HIGH**: `high`

pages/toolkits/sales/hubspot/reference.mdx

@@ -0,0 +1,33 @@
+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 = "Hubspot.AssociateActivityToDeal";
+
+// 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 = {
+  "activity_type": "call",
+  "activity_id": 987654321,
+  "deal_id": 123456
+};
+
+const response = await client.tools.execute({
+  tool_name: TOOL_NAME,
+  input: toolInput,
+  user_id: USER_ID,
+});
+
+console.log(JSON.stringify(response.output.value, null, 2));

public/examples/integrations/toolkits/hubspot/associate_activity_to_deal_example_call_tool.js

@@ -0,0 +1,29 @@
+import json
+from arcadepy import Arcade
+
+client = Arcade()  # Automatically finds the `ARCADE_API_KEY` env variable
+
+USER_ID = "{arcade_user_id}"
+TOOL_NAME = "Hubspot.AssociateActivityToDeal"
+
+auth_response = client.tools.authorize(
+    tool_name=TOOL_NAME,
+    user_id=TOOL_NAME
+)
+
+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 = {
+    'activity_type': 'call', 'activity_id': 987654321, 'deal_id': 123456
+}
+
+response = client.tools.execute(
+    tool_name=TOOL_NAME,
+    input=tool_input,
+    user_id=USER_ID,
+)
+print(json.dumps(response.output.value, indent=2))

public/examples/integrations/toolkits/hubspot/associate_activity_to_deal_example_call_tool.py

@@ -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 = "Hubspot.AssociateContactToDeal";
+
+// 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 = {
+  "deal_id": 12345,
+  "contact_id": 67890
+};
+
+const response = await client.tools.execute({
+  tool_name: TOOL_NAME,
+  input: toolInput,
+  user_id: USER_ID,
+});
+
+console.log(JSON.stringify(response.output.value, null, 2));

public/examples/integrations/toolkits/hubspot/associate_contact_to_deal_example_call_tool.js

@@ -0,0 +1,29 @@
+import json
+from arcadepy import Arcade
+
+client = Arcade()  # Automatically finds the `ARCADE_API_KEY` env variable
+
+USER_ID = "{arcade_user_id}"
+TOOL_NAME = "Hubspot.AssociateContactToDeal"
+
+auth_response = client.tools.authorize(
+    tool_name=TOOL_NAME,
+    user_id=TOOL_NAME
+)
+
+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 = {
+    'deal_id': 12345, 'contact_id': 67890
+}
+
+response = client.tools.execute(
+    tool_name=TOOL_NAME,
+    input=tool_input,
+    user_id=USER_ID,
+)
+print(json.dumps(response.output.value, indent=2))

public/examples/integrations/toolkits/hubspot/associate_contact_to_deal_example_call_tool.py

@@ -0,0 +1,39 @@
+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 = "Hubspot.CreateCallActivity";
+
+// 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 = {
+  "title": "Intro call with Acme",
+  "when_occurred": "2025-09-12T10:30:00",
+  "direction": "OUTBOUND",
+  "summary": "Discussed project scope and next steps; agreed to send proposal.",
+  "duration": 900,
+  "to_number": "+14155550123",
+  "from_number": "+14155550987",
+  "associate_to_contact_id": 7854,
+  "associate_to_company_id": 120
+};
+
+const response = await client.tools.execute({
+  tool_name: TOOL_NAME,
+  input: toolInput,
+  user_id: USER_ID,
+});
+
+console.log(JSON.stringify(response.output.value, null, 2));

public/examples/integrations/toolkits/hubspot/create_call_activity_example_call_tool.js

@@ -0,0 +1,37 @@
+import json
+from arcadepy import Arcade
+
+client = Arcade()  # Automatically finds the `ARCADE_API_KEY` env variable
+
+USER_ID = "{arcade_user_id}"
+TOOL_NAME = "Hubspot.CreateCallActivity"
+
+auth_response = client.tools.authorize(
+    tool_name=TOOL_NAME,
+    user_id=TOOL_NAME
+)
+
+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 = {
+    'title': 'Intro call with Acme',
+    'when_occurred': '2025-09-12T10:30:00',
+    'direction': 'OUTBOUND',
+    'summary': 'Discussed project scope and next steps; agreed to send proposal.',
+    'duration': 900,
+    'to_number': '+14155550123',
+    'from_number': '+14155550987',
+    'associate_to_contact_id': 7854,
+    'associate_to_company_id': 120
+}
+
+response = client.tools.execute(
+    tool_name=TOOL_NAME,
+    input=tool_input,
+    user_id=USER_ID,
+)
+print(json.dumps(response.output.value, indent=2))

public/examples/integrations/toolkits/hubspot/create_call_activity_example_call_tool.py

@@ -0,0 +1,34 @@
+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 = "Hubspot.CreateCommunicationActivity";
+
+// 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 = {
+  "channel": "WHATS_APP",
+  "when_occurred": "2025-09-12T14:30:00",
+  "body_text": "Sent product pricing and next steps. Awaiting confirmation.",
+  "associate_to_contact_id": 7421
+};
+
+const response = await client.tools.execute({
+  tool_name: TOOL_NAME,
+  input: toolInput,
+  user_id: USER_ID,
+});
+
+console.log(JSON.stringify(response.output.value, null, 2));

public/examples/integrations/toolkits/hubspot/create_communication_activity_example_call_tool.js

@@ -0,0 +1,32 @@
+import json
+from arcadepy import Arcade
+
+client = Arcade()  # Automatically finds the `ARCADE_API_KEY` env variable
+
+USER_ID = "{arcade_user_id}"
+TOOL_NAME = "Hubspot.CreateCommunicationActivity"
+
+auth_response = client.tools.authorize(
+    tool_name=TOOL_NAME,
+    user_id=TOOL_NAME
+)
+
+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 = {
+    'channel': 'WHATS_APP',
+    'when_occurred': '2025-09-12T14:30:00',
+    'body_text': 'Sent product pricing and next steps. Awaiting confirmation.',
+    'associate_to_contact_id': 7421
+}
+
+response = client.tools.execute(
+    tool_name=TOOL_NAME,
+    input=tool_input,
+    user_id=USER_ID,
+)
+print(json.dumps(response.output.value, indent=2))