Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
824 changes: 785 additions & 39 deletions pages/toolkits/sales/hubspot.mdx

Large diffs are not rendered by default.

64 changes: 64 additions & 0 deletions pages/toolkits/sales/hubspot/reference.mdx
Original file line number Diff line number Diff line change
@@ -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`
Original file line number Diff line number Diff line change
@@ -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));
Original file line number Diff line number Diff line change
@@ -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))
Original file line number Diff line number Diff line change
@@ -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));
Original file line number Diff line number Diff line change
@@ -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))
Original file line number Diff line number Diff line change
@@ -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));
Original file line number Diff line number Diff line change
@@ -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))
Original file line number Diff line number Diff line change
@@ -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));
Original file line number Diff line number Diff line change
@@ -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))
Original file line number Diff line number Diff line change
@@ -0,0 +1,38 @@
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.CreateCompany";

// 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 = {
"company_name": "Acme Analytics",
"web_domain": "acme-analytics.com",
"industry_type": "technology",
"company_city": "San Francisco",
"company_state": "CA",
"company_country": "USA",
"phone_number": "+1-415-555-0102",
"website_url": "https://www.acme-analytics.com"
};

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));
Loading