@matimo/hubspot 0.1.0-alpha.9

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

@@ -0,0 +1,59 @@
+name: hubspot-list-contacts
+version: '1.0.0'
+description: List all contacts from HubSpot CRM with pagination.
+
+parameters:
+  limit:
+    type: number
+    required: false
+    description: Maximum number of contacts to return (default 10, max 100).
+  after:
+    type: string
+    required: false
+    description: Pagination cursor to get next batch of contacts.
+  properties:
+    type: array
+    required: false
+    description: Specific properties to return for each contact.
+
+execution:
+  type: http
+  method: GET
+  url: 'https://api.hubapi.com/crm/v3/objects/contacts'
+  headers:
+    Authorization: 'Bearer {MATIMO_HUBSPOT_API_KEY}'
+  query_params:
+    limit: '{limit}'
+    after: '{after}'
+    properties: '{properties}'
+  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 contacts'
+    params:
+      limit: 10
+    expected_result: 'Array of 10 contacts with pagination info.'
+  - name: 'List contacts with cursor'
+    params:
+      limit: 20
+      after: 'cursor-value-here'
+    expected_result: 'Next batch of 20 contacts.'

package/tools/hubspot-list-custom-objects/definition.yaml

@@ -0,0 +1,60 @@
+name: hubspot-list-custom-objects
+version: '1.0.0'
+description: List custom objects from HubSpot CRM with pagination support.
+
+parameters:
+  object_type:
+    type: string
+    required: true
+    description: The custom object type ID (e.g., 'my_custom_object').
+  limit:
+    type: number
+    required: false
+    description: Maximum number of objects to retrieve (default 10, max 100).
+  after:
+    type: string
+    required: false
+    description: Pagination cursor for retrieving next page of results.
+  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}'
+  headers:
+    Authorization: 'Bearer {MATIMO_HUBSPOT_API_KEY}'
+  query_params:
+    limit: '{limit}'
+    after: '{after}'
+    properties: '{properties}'
+  timeout: 30000
+
+authentication:
+  type: bearer
+  location: header
+  name: Authorization
+
+output_schema:
+  type: object
+  properties:
+    results:
+      type: array
+    paging:
+      type: object
+
+error_handling:
+  retry: 2
+  backoff_type: exponential
+  initial_delay_ms: 500
+
+requires_approval: false
+
+examples:
+  - name: List custom objects
+    params:
+      object_type: my_custom_object
+      limit: 50
+    expected_result: Array of up to 50 custom objects

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

@@ -0,0 +1,49 @@
+name: hubspot-list-deals
+version: '1.0.0'
+description: List all deals from HubSpot CRM with pagination.
+
+parameters:
+  limit:
+    type: number
+    required: false
+    description: Maximum number of deals to return (default 10, max 100).
+  after:
+    type: string
+    required: false
+    description: Pagination cursor to get next batch of deals.
+
+execution:
+  type: http
+  method: GET
+  url: 'https://api.hubapi.com/crm/v3/objects/deals'
+  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 deals'
+    params:
+      limit: 10
+    expected_result: 'Array of 10 deals.'

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

@@ -0,0 +1,55 @@
+name: hubspot-list-invoices
+version: '1.0.0'
+description: List invoices from HubSpot CRM with pagination support.
+
+parameters:
+  limit:
+    type: number
+    required: false
+    description: Maximum number of invoices to retrieve (default 10, max 100).
+  after:
+    type: string
+    required: false
+    description: Pagination cursor for retrieving next page of results.
+  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'
+  headers:
+    Authorization: 'Bearer {MATIMO_HUBSPOT_API_KEY}'
+  query_params:
+    limit: '{limit}'
+    after: '{after}'
+    properties: '{properties}'
+  timeout: 30000
+
+authentication:
+  type: bearer
+  location: header
+  name: Authorization
+
+output_schema:
+  type: object
+  properties:
+    results:
+      type: array
+    paging:
+      type: object
+
+error_handling:
+  retry: 2
+  backoff_type: exponential
+  initial_delay_ms: 500
+
+requires_approval: false
+
+examples:
+  - name: List invoices
+    params:
+      limit: 50
+    expected_result: Array of up to 50 invoices

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

@@ -0,0 +1,61 @@
+name: hubspot-list-leads
+version: '1.0.0'
+description: List leads from HubSpot CRM with pagination support.
+
+parameters:
+  limit:
+    type: number
+    required: false
+    description: Maximum number of leads to retrieve (default 10, max 100).
+  after:
+    type: string
+    required: false
+    description: Pagination cursor for retrieving next page of results.
+  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/leads'
+  headers:
+    Authorization: 'Bearer {MATIMO_HUBSPOT_API_KEY}'
+  query_params:
+    limit: '{limit}'
+    after: '{after}'
+    properties: '{properties}'
+  timeout: 30000
+
+authentication:
+  type: bearer
+  location: header
+  name: Authorization
+
+output_schema:
+  type: object
+  properties:
+    results:
+      type: array
+    paging:
+      type: object
+  required:
+    - results
+
+error_handling:
+  retry: 2
+  backoff_type: exponential
+  initial_delay_ms: 500
+
+requires_approval: false
+
+examples:
+  - name: List leads with pagination
+    params:
+      limit: 50
+      properties:
+        - email
+        - firstname
+        - lastname
+    expected_result: Array of up to 50 leads with email, firstname, lastname

package/tools/hubspot-list-line-items/definition.yaml

@@ -0,0 +1,55 @@
+name: hubspot-list-line-items
+version: '1.0.0'
+description: List line items from HubSpot CRM with pagination support.
+
+parameters:
+  limit:
+    type: number
+    required: false
+    description: Maximum number of line items to retrieve (default 10, max 100).
+  after:
+    type: string
+    required: false
+    description: Pagination cursor for retrieving next page of results.
+  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'
+  headers:
+    Authorization: 'Bearer {MATIMO_HUBSPOT_API_KEY}'
+  query_params:
+    limit: '{limit}'
+    after: '{after}'
+    properties: '{properties}'
+  timeout: 30000
+
+authentication:
+  type: bearer
+  location: header
+  name: Authorization
+
+output_schema:
+  type: object
+  properties:
+    results:
+      type: array
+    paging:
+      type: object
+
+error_handling:
+  retry: 2
+  backoff_type: exponential
+  initial_delay_ms: 500
+
+requires_approval: false
+
+examples:
+  - name: List line items
+    params:
+      limit: 50
+    expected_result: Array of up to 50 line items

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

@@ -0,0 +1,55 @@
+name: hubspot-list-orders
+version: '1.0.0'
+description: List orders from HubSpot CRM with pagination support.
+
+parameters:
+  limit:
+    type: number
+    required: false
+    description: Maximum number of orders to retrieve (default 10, max 100).
+  after:
+    type: string
+    required: false
+    description: Pagination cursor for retrieving next page of results.
+  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'
+  headers:
+    Authorization: 'Bearer {MATIMO_HUBSPOT_API_KEY}'
+  query_params:
+    limit: '{limit}'
+    after: '{after}'
+    properties: '{properties}'
+  timeout: 30000
+
+authentication:
+  type: bearer
+  location: header
+  name: Authorization
+
+output_schema:
+  type: object
+  properties:
+    results:
+      type: array
+    paging:
+      type: object
+
+error_handling:
+  retry: 2
+  backoff_type: exponential
+  initial_delay_ms: 500
+
+requires_approval: false
+
+examples:
+  - name: List orders
+    params:
+      limit: 50
+    expected_result: Array of up to 50 orders

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

@@ -0,0 +1,55 @@
+name: hubspot-list-products
+version: '1.0.0'
+description: List products from HubSpot CRM with pagination support.
+
+parameters:
+  limit:
+    type: number
+    required: false
+    description: Maximum number of products to retrieve (default 10, max 100).
+  after:
+    type: string
+    required: false
+    description: Pagination cursor for retrieving next page of results.
+  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'
+  headers:
+    Authorization: 'Bearer {MATIMO_HUBSPOT_API_KEY}'
+  query_params:
+    limit: '{limit}'
+    after: '{after}'
+    properties: '{properties}'
+  timeout: 30000
+
+authentication:
+  type: bearer
+  location: header
+  name: Authorization
+
+output_schema:
+  type: object
+  properties:
+    results:
+      type: array
+    paging:
+      type: object
+
+error_handling:
+  retry: 2
+  backoff_type: exponential
+  initial_delay_ms: 500
+
+requires_approval: false
+
+examples:
+  - name: List products
+    params:
+      limit: 50
+    expected_result: Array of up to 50 products

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

@@ -0,0 +1,49 @@
+name: hubspot-list-tickets
+version: '1.0.0'
+description: List all tickets from HubSpot CRM with pagination.
+
+parameters:
+  limit:
+    type: number
+    required: false
+    description: Maximum number of tickets to return (default 10, max 100).
+  after:
+    type: string
+    required: false
+    description: Pagination cursor to get next batch of tickets.
+
+execution:
+  type: http
+  method: GET
+  url: 'https://api.hubapi.com/crm/v3/objects/tickets'
+  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 tickets'
+    params:
+      limit: 10
+    expected_result: 'Array of 10 tickets.'

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

@@ -0,0 +1,54 @@
+name: hubspot-update-company
+version: '1.0.0'
+description: Update an existing company in HubSpot CRM.
+
+parameters:
+  id:
+    type: string
+    required: true
+    description: The HubSpot company ID to update.
+  properties:
+    type: object
+    required: true
+    description: Object containing company properties to update.
+
+execution:
+  type: http
+  method: PATCH
+  url: 'https://api.hubapi.com/crm/v3/objects/companies/{id}'
+  headers:
+    Authorization: 'Bearer {MATIMO_HUBSPOT_API_KEY}'
+    Content-Type: application/json
+  body:
+    properties: '{properties}'
+  timeout: 30000
+
+authentication:
+  type: bearer
+  location: header
+  name: Authorization
+  notes:
+    env: MATIMO_HUBSPOT_API_KEY
+
+requires_approval: true
+
+output_schema:
+  type: object
+  properties:
+    id: { type: string }
+    properties: { type: object }
+    updatedAt: { type: string }
+  required: [id, properties]
+
+error_handling:
+  retry: 2
+  backoff_type: exponential
+  initial_delay_ms: 500
+
+examples:
+  - name: 'Update company name'
+    params:
+      id: '456'
+      properties:
+        name: 'Updated Company Name'
+    expected_result: 'Updated company with new name.'

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

@@ -0,0 +1,62 @@
+name: hubspot-update-contact
+version: '1.0.0'
+description: Update an existing contact in HubSpot CRM.
+
+parameters:
+  id:
+    type: string
+    required: true
+    description: The HubSpot contact ID to update.
+  properties:
+    type: object
+    required: true
+    description: Object containing contact properties to update (e.g., firstname, lastname, email, phone).
+
+execution:
+  type: http
+  method: PATCH
+  url: 'https://api.hubapi.com/crm/v3/objects/contacts/{id}'
+  headers:
+    Authorization: 'Bearer {MATIMO_HUBSPOT_API_KEY}'
+    Content-Type: application/json
+  body:
+    properties: '{properties}'
+  timeout: 30000
+
+authentication:
+  type: bearer
+  location: header
+  name: Authorization
+  notes:
+    env: MATIMO_HUBSPOT_API_KEY
+
+requires_approval: true
+
+output_schema:
+  type: object
+  properties:
+    id: { type: string }
+    properties: { type: object }
+    updatedAt: { type: string }
+  required: [id, properties]
+
+error_handling:
+  retry: 2
+  backoff_type: exponential
+  initial_delay_ms: 500
+
+examples:
+  - name: 'Update contact email'
+    params:
+      id: '123'
+      properties:
+        email: 'newemail@example.com'
+    expected_result: 'Updated contact with new email.'
+  - name: 'Update multiple properties'
+    params:
+      id: '123'
+      properties:
+        firstname: 'Jane'
+        lastname: 'Doe'
+        phone: '+1-555-0100'
+    expected_result: 'Updated contact with new properties.'

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

@@ -0,0 +1,57 @@
+name: hubspot-update-custom-object
+version: '1.0.0'
+description: Update a custom object in 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: object
+    required: true
+    description: Object containing properties to update.
+
+execution:
+  type: http
+  method: PATCH
+  url: 'https://api.hubapi.com/crm/v3/objects/{object_type}/{id}'
+  headers:
+    Authorization: 'Bearer {MATIMO_HUBSPOT_API_KEY}'
+    Content-Type: application/json
+  body:
+    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: true
+
+examples:
+  - name: Update a custom object
+    params:
+      object_type: my_custom_object
+      id: "12345"
+      properties:
+        name: Updated Name
+    expected_result: Custom object updated