@commandable/integration-data 0.4.0 → 0.4.1

package/integrations/hubspot/prompt.md

@@ -0,0 +1,69 @@
+## HubSpot guidance
+
+This integration uses HubSpot CRM v3 object endpoints and CRM v4 association endpoints.
+
+- Prefer `search_*` tools for discovery (they support free-text `query` and structured `filters`).
+- Use `get_*` tools when you already have an object ID and want full details / associations.
+
+### Search filters
+
+All `search_*` tools accept:
+
+- `query`: free-text search (optional)
+- `filters`: property-based filtering. Each filter is `{ propertyName, operator, value? }`.
+
+Common operators:
+
+- `EQ`, `NEQ`
+- `LT`, `LTE`, `GT`, `GTE` (numbers or millisecond timestamps)
+- `CONTAINS_TOKEN` (tokenized contains)
+- `HAS_PROPERTY`, `NOT_HAS_PROPERTY` (value ignored)
+- `BETWEEN` (pass `value` as a string `"low,high"`; timestamps in ms recommended)
+
+### Common property names (quick reference)
+
+Contacts:
+- `firstname`, `lastname`, `email`
+
+Companies:
+- `name`, `domain`
+
+Deals:
+- `dealname`, `amount`, `pipeline`, `dealstage`, `closedate`
+
+Tickets:
+- `subject`, `content`, `hs_pipeline`, `hs_pipeline_stage`
+
+### Pipelines and stages (deals/tickets)
+
+Pipelines and stages are stored as IDs (not human-friendly names). Recommended workflow:
+
+1. Call `list_pipelines` with `objectType: "deals"` or `objectType: "tickets"`.
+2. Pick a pipeline ID and stage ID from the response.
+3. Use those IDs when calling `create_deal` / `update_deal` (via `pipeline` / `dealstage`) or `create_ticket` / `update_ticket` (via `hs_pipeline` / `hs_pipeline_stage`).
+
+### Associations
+
+- Use `get_associations` to list linked records (returns associated IDs).
+- Use `create_association` to link two records (default/unlabeled association).
+- Use `remove_association` to unlink records.
+
+### Engagement objects
+
+Notes:
+- Content: `hs_note_body`
+- Timestamp: `hs_timestamp` (milliseconds)
+
+Tasks:
+- Subject: `hs_task_subject`
+- Body: `hs_task_body`
+- Status: `hs_task_status` (`NOT_STARTED` or `COMPLETED`)
+- Priority: `hs_task_priority` (`LOW`, `MEDIUM`, `HIGH`)
+- Due timestamp: `hs_timestamp` (milliseconds)
+
+The `create_note` and `create_task` tools can also associate the engagement to CRM records in the same call.
+
+### Pagination
+
+HubSpot uses cursor-based pagination. When a response includes `paging.next.after`, pass that value back as `after` in your next call.
+

package/integrations/hubspot/schemas/archive_company.json

@@ -0,0 +1,13 @@
+{
+  "type": "object",
+  "properties": {
+    "id": {
+      "type": "string",
+      "title": "Company ID",
+      "description": "HubSpot company object ID."
+    }
+  },
+  "required": ["id"],
+  "additionalProperties": false
+}
+

package/integrations/hubspot/schemas/archive_contact.json

@@ -0,0 +1,13 @@
+{
+  "type": "object",
+  "properties": {
+    "id": {
+      "type": "string",
+      "title": "Contact ID",
+      "description": "HubSpot contact object ID."
+    }
+  },
+  "required": ["id"],
+  "additionalProperties": false
+}
+

package/integrations/hubspot/schemas/archive_deal.json

@@ -0,0 +1,9 @@
+{
+  "type": "object",
+  "properties": {
+    "id": { "type": "string", "description": "HubSpot deal object ID." }
+  },
+  "required": ["id"],
+  "additionalProperties": false
+}
+

package/integrations/hubspot/schemas/archive_ticket.json

@@ -0,0 +1,9 @@
+{
+  "type": "object",
+  "properties": {
+    "id": { "type": "string", "description": "HubSpot ticket object ID." }
+  },
+  "required": ["id"],
+  "additionalProperties": false
+}
+

package/integrations/hubspot/schemas/create_association.json

@@ -0,0 +1,24 @@
+{
+  "type": "object",
+  "properties": {
+    "fromObjectType": {
+      "type": "string",
+      "description": "Object type of the source record (e.g. contacts, companies, deals, tickets)."
+    },
+    "fromObjectId": {
+      "type": "string",
+      "description": "Object ID of the source record."
+    },
+    "toObjectType": {
+      "type": "string",
+      "description": "Object type of the target record."
+    },
+    "toObjectId": {
+      "type": "string",
+      "description": "Object ID of the target record."
+    }
+  },
+  "required": ["fromObjectType", "fromObjectId", "toObjectType", "toObjectId"],
+  "additionalProperties": false
+}
+

package/integrations/hubspot/schemas/create_company.json

@@ -0,0 +1,14 @@
+{
+  "type": "object",
+  "properties": {
+    "name": { "type": "string" },
+    "domain": { "type": "string" },
+    "properties": {
+      "type": "object",
+      "description": "Additional HubSpot company properties to set (propertyName -> value).",
+      "additionalProperties": true
+    }
+  },
+  "additionalProperties": false
+}
+

package/integrations/hubspot/schemas/create_contact.json

@@ -0,0 +1,15 @@
+{
+  "type": "object",
+  "properties": {
+    "firstname": { "type": "string" },
+    "lastname": { "type": "string" },
+    "email": { "type": "string" },
+    "properties": {
+      "type": "object",
+      "description": "Additional HubSpot contact properties to set (propertyName -> value).",
+      "additionalProperties": true
+    }
+  },
+  "additionalProperties": false
+}
+

package/integrations/hubspot/schemas/create_deal.json

@@ -0,0 +1,20 @@
+{
+  "type": "object",
+  "properties": {
+    "dealname": { "type": "string", "description": "Deal name (maps to dealname property)." },
+    "amount": { "type": ["string", "number"], "description": "Deal amount (maps to amount property)." },
+    "pipeline": { "type": "string", "description": "Pipeline ID (maps to pipeline property)." },
+    "dealstage": { "type": "string", "description": "Deal stage ID (maps to dealstage property)." },
+    "closedate": {
+      "type": ["string", "number"],
+      "description": "Close date. Prefer Unix timestamp in milliseconds (maps to closedate property)."
+    },
+    "properties": {
+      "type": "object",
+      "description": "Additional HubSpot deal properties to set (propertyName -> value).",
+      "additionalProperties": true
+    }
+  },
+  "additionalProperties": false
+}
+

package/integrations/hubspot/schemas/create_note.json

@@ -0,0 +1,37 @@
+{
+  "type": "object",
+  "properties": {
+    "body": {
+      "type": "string",
+      "description": "Note text content. The handler maps this to hs_note_body."
+    },
+    "timestamp": {
+      "type": ["string", "number"],
+      "description": "Timestamp for hs_timestamp. Prefer Unix timestamp in milliseconds. If omitted, current time is used."
+    },
+    "hubspot_owner_id": {
+      "type": ["string", "number"],
+      "description": "Optional owner ID to attribute the note to."
+    },
+    "associateWith": {
+      "type": "array",
+      "description": "CRM records to associate this note with.",
+      "items": {
+        "type": "object",
+        "properties": {
+          "objectType": { "type": "string", "description": "e.g. contacts, companies, deals, tickets" },
+          "objectId": { "type": "string", "description": "HubSpot object ID" }
+        },
+        "required": ["objectType", "objectId"],
+        "additionalProperties": false
+      }
+    },
+    "properties": {
+      "type": "object",
+      "description": "Advanced: raw HubSpot note properties to set/override (propertyName -> value).",
+      "additionalProperties": true
+    }
+  },
+  "additionalProperties": false
+}
+

package/integrations/hubspot/schemas/create_task.json

@@ -0,0 +1,51 @@
+{
+  "type": "object",
+  "properties": {
+    "subject": {
+      "type": "string",
+      "description": "Task subject/title (maps to hs_task_subject)."
+    },
+    "body": {
+      "type": "string",
+      "description": "Task body/notes (maps to hs_task_body)."
+    },
+    "status": {
+      "type": "string",
+      "enum": ["NOT_STARTED", "COMPLETED"],
+      "description": "Task status (maps to hs_task_status)."
+    },
+    "priority": {
+      "type": "string",
+      "enum": ["LOW", "MEDIUM", "HIGH"],
+      "description": "Task priority (maps to hs_task_priority)."
+    },
+    "dueTimestamp": {
+      "type": ["string", "number"],
+      "description": "Due date/time timestamp for the task. HubSpot tasks use hs_timestamp for due date. Prefer Unix timestamp in milliseconds."
+    },
+    "hubspot_owner_id": {
+      "type": ["string", "number"],
+      "description": "Optional owner ID to assign the task to."
+    },
+    "associateWith": {
+      "type": "array",
+      "description": "CRM records to associate this task with.",
+      "items": {
+        "type": "object",
+        "properties": {
+          "objectType": { "type": "string", "description": "e.g. contacts, companies, deals, tickets" },
+          "objectId": { "type": "string", "description": "HubSpot object ID" }
+        },
+        "required": ["objectType", "objectId"],
+        "additionalProperties": false
+      }
+    },
+    "properties": {
+      "type": "object",
+      "description": "Advanced: raw HubSpot task properties to set/override (propertyName -> value).",
+      "additionalProperties": true
+    }
+  },
+  "additionalProperties": false
+}
+

package/integrations/hubspot/schemas/create_ticket.json

@@ -0,0 +1,16 @@
+{
+  "type": "object",
+  "properties": {
+    "subject": { "type": "string", "description": "Ticket subject (maps to subject property)." },
+    "content": { "type": "string", "description": "Ticket content/body (maps to content property)." },
+    "hs_pipeline": { "type": "string", "description": "Pipeline ID (maps to hs_pipeline property)." },
+    "hs_pipeline_stage": { "type": "string", "description": "Pipeline stage ID (maps to hs_pipeline_stage property)." },
+    "properties": {
+      "type": "object",
+      "description": "Additional HubSpot ticket properties to set (propertyName -> value).",
+      "additionalProperties": true
+    }
+  },
+  "additionalProperties": false
+}
+

package/integrations/hubspot/schemas/empty.json

@@ -0,0 +1,6 @@
+{
+  "type": "object",
+  "properties": {},
+  "additionalProperties": false
+}
+

package/integrations/hubspot/schemas/get_associations.json

@@ -0,0 +1,30 @@
+{
+  "type": "object",
+  "properties": {
+    "fromObjectType": {
+      "type": "string",
+      "description": "Object type of the source record (e.g. contacts, companies, deals, tickets)."
+    },
+    "fromObjectId": {
+      "type": "string",
+      "description": "Object ID of the source record."
+    },
+    "toObjectType": {
+      "type": "string",
+      "description": "Object type of the associated records to list (e.g. companies, contacts, deals, tickets, notes, tasks)."
+    },
+    "after": {
+      "type": "string",
+      "description": "Paging cursor token."
+    },
+    "limit": {
+      "type": "integer",
+      "minimum": 1,
+      "maximum": 500,
+      "description": "Max results per page."
+    }
+  },
+  "required": ["fromObjectType", "fromObjectId", "toObjectType"],
+  "additionalProperties": false
+}
+

package/integrations/hubspot/schemas/get_company.json

@@ -0,0 +1,27 @@
+{
+  "type": "object",
+  "properties": {
+    "id": {
+      "type": "string",
+      "title": "Company ID",
+      "description": "HubSpot company object ID."
+    },
+    "properties": {
+      "type": "array",
+      "items": { "type": "string" },
+      "description": "Specific property names to return (e.g. name, domain, industry)."
+    },
+    "associations": {
+      "type": "array",
+      "items": { "type": "string" },
+      "description": "Associated object types to include (e.g. contacts, deals, tickets)."
+    },
+    "archived": {
+      "type": "boolean",
+      "description": "Whether to return archived records."
+    }
+  },
+  "required": ["id"],
+  "additionalProperties": false
+}
+

package/integrations/hubspot/schemas/get_contact.json

@@ -0,0 +1,27 @@
+{
+  "type": "object",
+  "properties": {
+    "id": {
+      "type": "string",
+      "title": "Contact ID",
+      "description": "HubSpot contact object ID."
+    },
+    "properties": {
+      "type": "array",
+      "items": { "type": "string" },
+      "description": "Specific property names to return (e.g. firstname, lastname, email, phone)."
+    },
+    "associations": {
+      "type": "array",
+      "items": { "type": "string" },
+      "description": "Associated object types to include (e.g. companies, deals, tickets)."
+    },
+    "archived": {
+      "type": "boolean",
+      "description": "Whether to return archived records."
+    }
+  },
+  "required": ["id"],
+  "additionalProperties": false
+}
+

package/integrations/hubspot/schemas/get_deal.json

@@ -0,0 +1,20 @@
+{
+  "type": "object",
+  "properties": {
+    "id": { "type": "string", "description": "HubSpot deal object ID." },
+    "properties": {
+      "type": "array",
+      "items": { "type": "string" },
+      "description": "Specific property names to return (e.g. dealname, amount, pipeline, dealstage, closedate)."
+    },
+    "associations": {
+      "type": "array",
+      "items": { "type": "string" },
+      "description": "Associated object types to include (e.g. contacts, companies, tickets)."
+    },
+    "archived": { "type": "boolean" }
+  },
+  "required": ["id"],
+  "additionalProperties": false
+}
+

package/integrations/hubspot/schemas/get_ticket.json

@@ -0,0 +1,20 @@
+{
+  "type": "object",
+  "properties": {
+    "id": { "type": "string", "description": "HubSpot ticket object ID." },
+    "properties": {
+      "type": "array",
+      "items": { "type": "string" },
+      "description": "Specific property names to return (e.g. subject, content, hs_pipeline, hs_pipeline_stage, hs_ticket_priority)."
+    },
+    "associations": {
+      "type": "array",
+      "items": { "type": "string" },
+      "description": "Associated object types to include (e.g. contacts, companies, deals)."
+    },
+    "archived": { "type": "boolean" }
+  },
+  "required": ["id"],
+  "additionalProperties": false
+}
+

package/integrations/hubspot/schemas/list_owners.json

@@ -0,0 +1,25 @@
+{
+  "type": "object",
+  "properties": {
+    "email": {
+      "type": "string",
+      "description": "Filter owners by email address."
+    },
+    "after": {
+      "type": "string",
+      "description": "Paging cursor token."
+    },
+    "limit": {
+      "type": "integer",
+      "minimum": 1,
+      "maximum": 500,
+      "description": "Max results per page."
+    },
+    "archived": {
+      "type": "boolean",
+      "description": "Whether to include archived owners."
+    }
+  },
+  "additionalProperties": false
+}
+

package/integrations/hubspot/schemas/list_pipelines.json

@@ -0,0 +1,13 @@
+{
+  "type": "object",
+  "properties": {
+    "objectType": {
+      "type": "string",
+      "title": "Object type",
+      "description": "HubSpot object type to list pipelines for (commonly deals or tickets)."
+    }
+  },
+  "required": ["objectType"],
+  "additionalProperties": false
+}
+

package/integrations/hubspot/schemas/list_properties.json

@@ -0,0 +1,17 @@
+{
+  "type": "object",
+  "properties": {
+    "objectType": {
+      "type": "string",
+      "title": "Object type",
+      "description": "HubSpot object type to list properties for (e.g. contacts, companies, deals, tickets, notes, tasks)."
+    },
+    "archived": {
+      "type": "boolean",
+      "description": "Whether to include archived properties."
+    }
+  },
+  "required": ["objectType"],
+  "additionalProperties": false
+}
+

package/integrations/hubspot/schemas/remove_association.json

@@ -0,0 +1,24 @@
+{
+  "type": "object",
+  "properties": {
+    "fromObjectType": {
+      "type": "string",
+      "description": "Object type of the source record (e.g. contacts, companies, deals, tickets)."
+    },
+    "fromObjectId": {
+      "type": "string",
+      "description": "Object ID of the source record."
+    },
+    "toObjectType": {
+      "type": "string",
+      "description": "Object type of the target record."
+    },
+    "toObjectId": {
+      "type": "string",
+      "description": "Object ID of the target record."
+    }
+  },
+  "required": ["fromObjectType", "fromObjectId", "toObjectType", "toObjectId"],
+  "additionalProperties": false
+}
+

package/integrations/hubspot/schemas/search_companies.json

@@ -0,0 +1,56 @@
+{
+  "type": "object",
+  "properties": {
+    "query": {
+      "type": "string",
+      "title": "Query",
+      "description": "Free-text search query (optional)."
+    },
+    "filters": {
+      "type": "array",
+      "title": "Filters",
+      "description": "Property-based filters converted into HubSpot filterGroups.",
+      "items": {
+        "type": "object",
+        "properties": {
+          "propertyName": { "type": "string" },
+          "operator": {
+            "type": "string",
+            "enum": [
+              "EQ",
+              "NEQ",
+              "LT",
+              "LTE",
+              "GT",
+              "GTE",
+              "BETWEEN",
+              "HAS_PROPERTY",
+              "NOT_HAS_PROPERTY",
+              "CONTAINS_TOKEN"
+            ]
+          },
+          "value": { "type": ["string", "number", "boolean"] }
+        },
+        "required": ["propertyName", "operator"],
+        "additionalProperties": false
+      }
+    },
+    "properties": {
+      "type": "array",
+      "items": { "type": "string" },
+      "description": "Which company properties to return. If omitted, HubSpot returns a default set."
+    },
+    "limit": {
+      "type": "integer",
+      "minimum": 1,
+      "maximum": 100,
+      "description": "Max results per page."
+    },
+    "after": {
+      "type": "string",
+      "description": "Paging cursor token (from paging.next.after)."
+    }
+  },
+  "additionalProperties": false
+}
+

package/integrations/hubspot/schemas/search_contacts.json

@@ -0,0 +1,56 @@
+{
+  "type": "object",
+  "properties": {
+    "query": {
+      "type": "string",
+      "title": "Query",
+      "description": "Free-text search query (optional)."
+    },
+    "filters": {
+      "type": "array",
+      "title": "Filters",
+      "description": "Property-based filters converted into HubSpot filterGroups.",
+      "items": {
+        "type": "object",
+        "properties": {
+          "propertyName": { "type": "string" },
+          "operator": {
+            "type": "string",
+            "enum": [
+              "EQ",
+              "NEQ",
+              "LT",
+              "LTE",
+              "GT",
+              "GTE",
+              "BETWEEN",
+              "HAS_PROPERTY",
+              "NOT_HAS_PROPERTY",
+              "CONTAINS_TOKEN"
+            ]
+          },
+          "value": { "type": ["string", "number", "boolean"] }
+        },
+        "required": ["propertyName", "operator"],
+        "additionalProperties": false
+      }
+    },
+    "properties": {
+      "type": "array",
+      "items": { "type": "string" },
+      "description": "Which contact properties to return. If omitted, HubSpot returns a default set."
+    },
+    "limit": {
+      "type": "integer",
+      "minimum": 1,
+      "maximum": 100,
+      "description": "Max results per page."
+    },
+    "after": {
+      "type": "string",
+      "description": "Paging cursor token (from paging.next.after)."
+    }
+  },
+  "additionalProperties": false
+}
+