@matimo/hubspot 0.1.0-alpha.9

package/tools/hubspot-delete-line-item/definition.yaml

@@ -0,0 +1,38 @@
+name: hubspot-delete-line-item
+version: '1.0.0'
+description: Delete a line item from HubSpot CRM.
+
+parameters:
+  id:
+    type: string
+    required: true
+    description: The HubSpot line item ID.
+
+execution:
+  type: http
+  method: DELETE
+  url: 'https://api.hubapi.com/crm/v3/objects/line_items/{id}'
+  headers:
+    Authorization: 'Bearer {MATIMO_HUBSPOT_API_KEY}'
+  timeout: 30000
+
+authentication:
+  type: bearer
+  location: header
+  name: Authorization
+
+output_schema:
+  type: object
+
+error_handling:
+  retry: 2
+  backoff_type: exponential
+  initial_delay_ms: 500
+
+requires_approval: true
+
+examples:
+  - name: Delete a line item
+    params:
+      id: "12345"
+    expected_result: Line item deleted

package/tools/hubspot-delete-order/definition.yaml

@@ -0,0 +1,38 @@
+name: hubspot-delete-order
+version: '1.0.0'
+description: Delete an order from HubSpot CRM.
+
+parameters:
+  id:
+    type: string
+    required: true
+    description: The HubSpot order ID.
+
+execution:
+  type: http
+  method: DELETE
+  url: 'https://api.hubapi.com/crm/v3/objects/orders/{id}'
+  headers:
+    Authorization: 'Bearer {MATIMO_HUBSPOT_API_KEY}'
+  timeout: 30000
+
+authentication:
+  type: bearer
+  location: header
+  name: Authorization
+
+output_schema:
+  type: object
+
+error_handling:
+  retry: 2
+  backoff_type: exponential
+  initial_delay_ms: 500
+
+requires_approval: true
+
+examples:
+  - name: Delete an order
+    params:
+      id: "12345"
+    expected_result: Order deleted

package/tools/hubspot-delete-product/definition.yaml

@@ -0,0 +1,38 @@
+name: hubspot-delete-product
+version: '1.0.0'
+description: Delete a product from HubSpot CRM.
+
+parameters:
+  id:
+    type: string
+    required: true
+    description: The HubSpot product ID.
+
+execution:
+  type: http
+  method: DELETE
+  url: 'https://api.hubapi.com/crm/v3/objects/products/{id}'
+  headers:
+    Authorization: 'Bearer {MATIMO_HUBSPOT_API_KEY}'
+  timeout: 30000
+
+authentication:
+  type: bearer
+  location: header
+  name: Authorization
+
+output_schema:
+  type: object
+
+error_handling:
+  retry: 2
+  backoff_type: exponential
+  initial_delay_ms: 500
+
+requires_approval: true
+
+examples:
+  - name: Delete a product
+    params:
+      id: "12345"
+    expected_result: Product deleted

package/tools/hubspot-delete-ticket/definition.yaml

@@ -0,0 +1,43 @@
+name: hubspot-delete-ticket
+version: '1.0.0'
+description: Delete a ticket from HubSpot CRM.
+
+parameters:
+  id:
+    type: string
+    required: true
+    description: The HubSpot ticket ID to delete.
+
+execution:
+  type: http
+  method: DELETE
+  url: 'https://api.hubapi.com/crm/v3/objects/tickets/{id}'
+  headers:
+    Authorization: 'Bearer {MATIMO_HUBSPOT_API_KEY}'
+  timeout: 30000
+
+authentication:
+  type: bearer
+  location: header
+  name: Authorization
+  notes:
+    env: MATIMO_HUBSPOT_API_KEY
+
+requires_approval: true
+
+output_schema:
+  type: object
+  properties:
+    status: { type: string }
+  required: [status]
+
+error_handling:
+  retry: 2
+  backoff_type: exponential
+  initial_delay_ms: 500
+
+examples:
+  - name: 'Delete ticket by ID'
+    params:
+      id: '999'
+    expected_result: 'Ticket successfully deleted.'

package/tools/hubspot-get-company/definition.yaml

@@ -0,0 +1,49 @@
+name: hubspot-get-company
+version: '1.0.0'
+description: Retrieve a specific company by ID from HubSpot CRM.
+
+parameters:
+  id:
+    type: string
+    required: true
+    description: The HubSpot company ID to retrieve.
+  properties:
+    type: array
+    required: false
+    description: Specific properties to return (e.g., name, domain, industry).
+
+execution:
+  type: http
+  method: GET
+  url: 'https://api.hubapi.com/crm/v3/objects/companies/{id}'
+  query_params:
+    properties: '{properties}'
+  headers:
+    Authorization: 'Bearer {MATIMO_HUBSPOT_API_KEY}'
+  timeout: 30000
+
+authentication:
+  type: bearer
+  location: header
+  name: Authorization
+  notes:
+    env: MATIMO_HUBSPOT_API_KEY
+
+output_schema:
+  type: object
+  properties:
+    id: { type: string }
+    properties: { type: object }
+    createdAt: { type: string }
+  required: [id, properties]
+
+error_handling:
+  retry: 2
+  backoff_type: exponential
+  initial_delay_ms: 500
+
+examples:
+  - name: 'Get company by ID'
+    params:
+      id: '456'
+    expected_result: 'Company object with all properties.'

package/tools/hubspot-get-contact/definition.yaml

@@ -0,0 +1,56 @@
+name: hubspot-get-contact
+version: '1.0.0'
+description: Retrieve a specific contact by ID from HubSpot CRM.
+
+parameters:
+  id:
+    type: string
+    required: true
+    description: The HubSpot contact ID to retrieve.
+  properties:
+    type: array
+    required: false
+    description: Specific properties to return (e.g., firstname, lastname, email). If not specified, all properties are returned.
+
+execution:
+  type: http
+  method: GET
+  url: 'https://api.hubapi.com/crm/v3/objects/contacts/{id}'
+  query_params:
+    properties: '{properties}'
+  headers:
+    Authorization: 'Bearer {MATIMO_HUBSPOT_API_KEY}'
+  timeout: 30000
+
+authentication:
+  type: bearer
+  location: header
+  name: Authorization
+  notes:
+    env: MATIMO_HUBSPOT_API_KEY
+
+output_schema:
+  type: object
+  properties:
+    id: { type: string }
+    properties: { type: object }
+    createdAt: { type: string }
+    updatedAt: { type: string }
+    archived: { type: boolean }
+  required: [id, properties]
+
+error_handling:
+  retry: 2
+  backoff_type: exponential
+  initial_delay_ms: 500
+
+examples:
+  - name: 'Get contact by ID'
+    params:
+      id: '123'
+    expected_result: 'Contact object with all properties.'
+  - name: 'Get specific properties'
+    params:
+      id: '123'
+      properties: ['firstname', 'lastname', 'email']
+    expected_result: 'Contact with only specified properties.'

package/tools/hubspot-get-custom-object/definition.yaml

@@ -0,0 +1,54 @@
+name: hubspot-get-custom-object
+version: '1.0.0'
+description: Retrieve a specific custom object by ID from HubSpot CRM.
+
+parameters:
+  object_type:
+    type: string
+    required: true
+    description: The custom object type ID (e.g., 'my_custom_object').
+  id:
+    type: string
+    required: true
+    description: The custom object ID.
+  properties:
+    type: array
+    required: false
+    description: Array of property names to retrieve.
+
+execution:
+  type: http
+  method: GET
+  url: 'https://api.hubapi.com/crm/v3/objects/{object_type}/{id}'
+  headers:
+    Authorization: 'Bearer {MATIMO_HUBSPOT_API_KEY}'
+  query_params:
+    properties: '{properties}'
+  timeout: 30000
+
+authentication:
+  type: bearer
+  location: header
+  name: Authorization
+
+output_schema:
+  type: object
+  properties:
+    id:
+      type: string
+    properties:
+      type: object
+
+error_handling:
+  retry: 2
+  backoff_type: exponential
+  initial_delay_ms: 500
+
+requires_approval: false
+
+examples:
+  - name: Get a custom object
+    params:
+      object_type: my_custom_object
+      id: "12345"
+    expected_result: Custom object with ID 12345

package/tools/hubspot-get-deal/definition.yaml

@@ -0,0 +1,42 @@
+name: hubspot-get-deal
+version: '1.0.0'
+description: Retrieve a specific deal by ID from HubSpot CRM.
+
+parameters:
+  id:
+    type: string
+    required: true
+    description: The HubSpot deal ID to retrieve.
+
+execution:
+  type: http
+  method: GET
+  url: 'https://api.hubapi.com/crm/v3/objects/deals/{id}'
+  headers:
+    Authorization: 'Bearer {MATIMO_HUBSPOT_API_KEY}'
+  timeout: 30000
+
+authentication:
+  type: bearer
+  location: header
+  name: Authorization
+  notes:
+    env: MATIMO_HUBSPOT_API_KEY
+
+output_schema:
+  type: object
+  properties:
+    id: { type: string }
+    properties: { type: object }
+  required: [id, properties]
+
+error_handling:
+  retry: 2
+  backoff_type: exponential
+  initial_delay_ms: 500
+
+examples:
+  - name: 'Get deal by ID'
+    params:
+      id: '789'
+    expected_result: 'Deal object with all properties.'

package/tools/hubspot-get-invoice/definition.yaml

@@ -0,0 +1,49 @@
+name: hubspot-get-invoice
+version: '1.0.0'
+description: Retrieve a specific invoice by ID from HubSpot CRM.
+
+parameters:
+  id:
+    type: string
+    required: true
+    description: The HubSpot invoice ID.
+  properties:
+    type: array
+    required: false
+    description: Array of property names to retrieve.
+
+execution:
+  type: http
+  method: GET
+  url: 'https://api.hubapi.com/crm/v3/objects/invoices/{id}'
+  headers:
+    Authorization: 'Bearer {MATIMO_HUBSPOT_API_KEY}'
+  query_params:
+    properties: '{properties}'
+  timeout: 30000
+
+authentication:
+  type: bearer
+  location: header
+  name: Authorization
+
+output_schema:
+  type: object
+  properties:
+    id:
+      type: string
+    properties:
+      type: object
+
+error_handling:
+  retry: 2
+  backoff_type: exponential
+  initial_delay_ms: 500
+
+requires_approval: false
+
+examples:
+  - name: Get an invoice
+    params:
+      id: "12345"
+    expected_result: Invoice with ID 12345

package/tools/hubspot-get-lead/definition.yaml

@@ -0,0 +1,55 @@
+name: hubspot-get-lead
+version: '1.0.0'
+description: Retrieve a specific lead by ID from HubSpot CRM.
+
+parameters:
+  id:
+    type: string
+    required: true
+    description: The HubSpot lead ID to retrieve.
+  properties:
+    type: array
+    required: false
+    description: Array of property names to retrieve (e.g., ['email', 'firstname', 'lastname']).
+
+execution:
+  type: http
+  method: GET
+  url: 'https://api.hubapi.com/crm/v3/objects/leads/{id}'
+  headers:
+    Authorization: 'Bearer {MATIMO_HUBSPOT_API_KEY}'
+  query_params:
+    properties: '{properties}'
+  timeout: 30000
+
+authentication:
+  type: bearer
+  location: header
+  name: Authorization
+
+output_schema:
+  type: object
+  properties:
+    id:
+      type: string
+    properties:
+      type: object
+  required:
+    - id
+
+error_handling:
+  retry: 2
+  backoff_type: exponential
+  initial_delay_ms: 500
+
+requires_approval: false
+
+examples:
+  - name: Get a lead by ID
+    params:
+      id: "12345"
+      properties:
+        - email
+        - firstname
+        - lastname
+    expected_result: Lead object with ID 12345 and specified properties

package/tools/hubspot-get-line-item/definition.yaml

@@ -0,0 +1,49 @@
+name: hubspot-get-line-item
+version: '1.0.0'
+description: Retrieve a specific line item by ID from HubSpot CRM.
+
+parameters:
+  id:
+    type: string
+    required: true
+    description: The HubSpot line item ID.
+  properties:
+    type: array
+    required: false
+    description: Array of property names to retrieve.
+
+execution:
+  type: http
+  method: GET
+  url: 'https://api.hubapi.com/crm/v3/objects/line_items/{id}'
+  headers:
+    Authorization: 'Bearer {MATIMO_HUBSPOT_API_KEY}'
+  query_params:
+    properties: '{properties}'
+  timeout: 30000
+
+authentication:
+  type: bearer
+  location: header
+  name: Authorization
+
+output_schema:
+  type: object
+  properties:
+    id:
+      type: string
+    properties:
+      type: object
+
+error_handling:
+  retry: 2
+  backoff_type: exponential
+  initial_delay_ms: 500
+
+requires_approval: false
+
+examples:
+  - name: Get a line item
+    params:
+      id: "12345"
+    expected_result: Line item with ID 12345

package/tools/hubspot-get-order/definition.yaml

@@ -0,0 +1,49 @@
+name: hubspot-get-order
+version: '1.0.0'
+description: Retrieve a specific order by ID from HubSpot CRM.
+
+parameters:
+  id:
+    type: string
+    required: true
+    description: The HubSpot order ID.
+  properties:
+    type: array
+    required: false
+    description: Array of property names to retrieve.
+
+execution:
+  type: http
+  method: GET
+  url: 'https://api.hubapi.com/crm/v3/objects/orders/{id}'
+  headers:
+    Authorization: 'Bearer {MATIMO_HUBSPOT_API_KEY}'
+  query_params:
+    properties: '{properties}'
+  timeout: 30000
+
+authentication:
+  type: bearer
+  location: header
+  name: Authorization
+
+output_schema:
+  type: object
+  properties:
+    id:
+      type: string
+    properties:
+      type: object
+
+error_handling:
+  retry: 2
+  backoff_type: exponential
+  initial_delay_ms: 500
+
+requires_approval: false
+
+examples:
+  - name: Get an order
+    params:
+      id: "12345"
+    expected_result: Order with ID 12345

package/tools/hubspot-get-product/definition.yaml

@@ -0,0 +1,49 @@
+name: hubspot-get-product
+version: '1.0.0'
+description: Retrieve a specific product by ID from HubSpot CRM.
+
+parameters:
+  id:
+    type: string
+    required: true
+    description: The HubSpot product ID.
+  properties:
+    type: array
+    required: false
+    description: Array of property names to retrieve.
+
+execution:
+  type: http
+  method: GET
+  url: 'https://api.hubapi.com/crm/v3/objects/products/{id}'
+  headers:
+    Authorization: 'Bearer {MATIMO_HUBSPOT_API_KEY}'
+  query_params:
+    properties: '{properties}'
+  timeout: 30000
+
+authentication:
+  type: bearer
+  location: header
+  name: Authorization
+
+output_schema:
+  type: object
+  properties:
+    id:
+      type: string
+    properties:
+      type: object
+
+error_handling:
+  retry: 2
+  backoff_type: exponential
+  initial_delay_ms: 500
+
+requires_approval: false
+
+examples:
+  - name: Get a product
+    params:
+      id: "12345"
+    expected_result: Product with ID 12345

package/tools/hubspot-get-ticket/definition.yaml

@@ -0,0 +1,42 @@
+name: hubspot-get-ticket
+version: '1.0.0'
+description: Retrieve a specific ticket by ID from HubSpot CRM.
+
+parameters:
+  id:
+    type: string
+    required: true
+    description: The HubSpot ticket ID to retrieve.
+
+execution:
+  type: http
+  method: GET
+  url: 'https://api.hubapi.com/crm/v3/objects/tickets/{id}'
+  headers:
+    Authorization: 'Bearer {MATIMO_HUBSPOT_API_KEY}'
+  timeout: 30000
+
+authentication:
+  type: bearer
+  location: header
+  name: Authorization
+  notes:
+    env: MATIMO_HUBSPOT_API_KEY
+
+output_schema:
+  type: object
+  properties:
+    id: { type: string }
+    properties: { type: object }
+  required: [id, properties]
+
+error_handling:
+  retry: 2
+  backoff_type: exponential
+  initial_delay_ms: 500
+
+examples:
+  - name: 'Get ticket by ID'
+    params:
+      id: '999'
+    expected_result: 'Ticket object with all properties.'

package/tools/hubspot-list-companies/definition.yaml

@@ -0,0 +1,49 @@
+name: hubspot-list-companies
+version: '1.0.0'
+description: List all companies from HubSpot CRM with pagination.
+
+parameters:
+  limit:
+    type: number
+    required: false
+    description: Maximum number of companies to return (default 10, max 100).
+  after:
+    type: string
+    required: false
+    description: Pagination cursor to get next batch of companies.
+
+execution:
+  type: http
+  method: GET
+  url: 'https://api.hubapi.com/crm/v3/objects/companies'
+  query_params:
+    limit: '{limit}'
+    after: '{after}'
+  headers:
+    Authorization: 'Bearer {MATIMO_HUBSPOT_API_KEY}'
+  timeout: 30000
+
+authentication:
+  type: bearer
+  location: header
+  name: Authorization
+  notes:
+    env: MATIMO_HUBSPOT_API_KEY
+
+output_schema:
+  type: object
+  properties:
+    results: { type: array }
+    paging: { type: object }
+  required: [results]
+
+error_handling:
+  retry: 2
+  backoff_type: exponential
+  initial_delay_ms: 500
+
+examples:
+  - name: 'List first 10 companies'
+    params:
+      limit: 10
+    expected_result: 'Array of 10 companies.'