KosmoKrator

productivity

HubSpot CLI for AI Agents

Use the HubSpot CLI from KosmoKrator to call HubSpot tools headlessly, return JSON, inspect schemas, and automate workflows from coding agents, scripts, and CI.

HubSpot CLI Setup

HubSpot can be configured headlessly with `kosmokrator integrations:configure hubspot`.

Install, configure, and verify 
# Install KosmoKrator first if it is not available on PATH.
curl -fsSL https://raw.githubusercontent.com/OpenCompanyApp/kosmokrator/main/install.sh | bash

# Configure and verify this integration.
kosmokrator integrations:configure hubspot --set access_token="$HUBSPOT_ACCESS_TOKEN" --enable --read allow --write ask --json
kosmokrator integrations:doctor hubspot --json
kosmokrator integrations:status --json

Credentials

Authentication type: Bearer token bearer_token. Configure credentials once, then reuse the same stored profile from scripts, coding CLIs, Lua, and MCP.

KeyEnv varTypeRequiredLabel
access_token HUBSPOT_ACCESS_TOKEN Secret secret yes Private App Access Token
base_url HUBSPOT_BASE_URL URL url no API Base URL

Command Patterns

The generic command is stable across every integration. The provider shortcut is shorter for humans.

Generic CLI call 
kosmo integrations:call hubspot.hubspot_create_contact '{"first_name":"example_first_name","last_name":"example_last_name","email":"example_email","phone":"example_phone","company":"example_company","properties":"example_properties"}' --json
Provider shortcut 
kosmo integrations:hubspot hubspot_create_contact '{"first_name":"example_first_name","last_name":"example_last_name","email":"example_email","phone":"example_phone","company":"example_company","properties":"example_properties"}' --json

Discovery

These commands return structured output for coding agents that need to inspect capabilities before choosing a function.

Discovery commands 
kosmo integrations:docs hubspot --json
kosmo integrations:docs hubspot.hubspot_create_contact --json
kosmo integrations:schema hubspot.hubspot_create_contact --json
kosmo integrations:search "HubSpot" --json
kosmo integrations:list --json

Automation Contexts

The same configured command surface works in these environments. The command does not change unless the host wrapper, credentials, or permissions change.

CI Run integration calls from CI jobs with JSON output, explicit credentials, and predictable exit status. Cron Jobs Schedule repeatable integration workflows from cron while keeping credentials in KosmoKrator config. Shell Scripts Call integration functions from shell scripts with stable JSON input and output. Headless Automation Use KosmoKrator as a non-interactive integration runtime for local automations and wrappers. Coding Agents Let coding agents discover schemas and execute integration functions through CLI commands or MCP.

CLI Functions

Every function below can be called headlessly. Commands are highlighted, copyable, and scroll horizontally when payloads are long.

hubspot.hubspot_create_contact

Create a new contact in HubSpot CRM. Supports firstname, lastname, email, phone, company, and any additional custom properties. Returns the created contact with its HubSpot ID and properties.

Write write
Parameters
first_name, last_name, email, phone, company, properties
Generic call 
kosmo integrations:call hubspot.hubspot_create_contact '{"first_name":"example_first_name","last_name":"example_last_name","email":"example_email","phone":"example_phone","company":"example_company","properties":"example_properties"}' --json
Shortcut 
kosmo integrations:hubspot hubspot_create_contact '{"first_name":"example_first_name","last_name":"example_last_name","email":"example_email","phone":"example_phone","company":"example_company","properties":"example_properties"}' --json

hubspot.hubspot_get_contact

Retrieve a HubSpot contact by its ID. Returns the contact's ID, properties, and associated data. Optionally specify which properties to include.

Read read
Parameters
id, properties
Generic call 
kosmo integrations:call hubspot.hubspot_get_contact '{"id":"example_id","properties":"example_properties"}' --json
Shortcut 
kosmo integrations:hubspot hubspot_get_contact '{"id":"example_id","properties":"example_properties"}' --json

hubspot.hubspot_update_contact

Update an existing HubSpot contact by ID. Provide a properties object with the fields to update (e.g., {"firstname": "Jane", "phone": "555-0100"}). Returns the updated contact.

Write write
Parameters
id, properties
Generic call 
kosmo integrations:call hubspot.hubspot_update_contact '{"id":"example_id","properties":"example_properties"}' --json
Shortcut 
kosmo integrations:hubspot hubspot_update_contact '{"id":"example_id","properties":"example_properties"}' --json

hubspot.hubspot_search_contacts

Search HubSpot contacts using filter groups and/or a text query. Use filterGroups for structured queries (e.g., email equals "x@y.com"). Use query for full-text search across searchable properties. Supports pagination with limit and after parameters.

Read read
Parameters
query, filter_groups, properties, limit, after
Generic call 
kosmo integrations:call hubspot.hubspot_search_contacts '{"query":"example_query","filter_groups":"example_filter_groups","properties":"example_properties","limit":1,"after":"example_after"}' --json
Shortcut 
kosmo integrations:hubspot hubspot_search_contacts '{"query":"example_query","filter_groups":"example_filter_groups","properties":"example_properties","limit":1,"after":"example_after"}' --json

hubspot.hubspot_delete_contact

Delete a HubSpot contact by ID. Permanently removes the contact from HubSpot CRM. This action cannot be undone.

Write write
Parameters
id
Generic call 
kosmo integrations:call hubspot.hubspot_delete_contact '{"id":"example_id"}' --json
Shortcut 
kosmo integrations:hubspot hubspot_delete_contact '{"id":"example_id"}' --json

hubspot.hubspot_create_or_update_contact

Create or update a HubSpot contact by email. First searches for an existing contact matching the email. If found, updates it. If not found, creates a new contact. Supports firstname, lastname, phone, company, and any additional custom properties.

Write write
Parameters
email, first_name, last_name, phone, company, properties
Generic call 
kosmo integrations:call hubspot.hubspot_create_or_update_contact '{"email":"example_email","first_name":"example_first_name","last_name":"example_last_name","phone":"example_phone","company":"example_company","properties":"example_properties"}' --json
Shortcut 
kosmo integrations:hubspot hubspot_create_or_update_contact '{"email":"example_email","first_name":"example_first_name","last_name":"example_last_name","phone":"example_phone","company":"example_company","properties":"example_properties"}' --json

hubspot.hubspot_list_contacts

List contacts in HubSpot CRM with cursor-based pagination and optional property selection.

Read read
Parameters
limit, after, properties
Generic call 
kosmo integrations:call hubspot.hubspot_list_contacts '{"limit":1,"after":"example_after","properties":"example_properties"}' --json
Shortcut 
kosmo integrations:hubspot hubspot_list_contacts '{"limit":1,"after":"example_after","properties":"example_properties"}' --json

hubspot.hubspot_create_company

Create a new company in HubSpot CRM. Supports name, domain, and any additional custom properties. Returns the created company with its HubSpot ID and properties.

Write write
Parameters
name, domain, properties
Generic call 
kosmo integrations:call hubspot.hubspot_create_company '{"name":"example_name","domain":"example_domain","properties":"example_properties"}' --json
Shortcut 
kosmo integrations:hubspot hubspot_create_company '{"name":"example_name","domain":"example_domain","properties":"example_properties"}' --json

hubspot.hubspot_get_company

Retrieve a HubSpot company by its ID. Returns the company's ID, properties, and associated data. Optionally specify which properties to include.

Read read
Parameters
id, properties
Generic call 
kosmo integrations:call hubspot.hubspot_get_company '{"id":"example_id","properties":"example_properties"}' --json
Shortcut 
kosmo integrations:hubspot hubspot_get_company '{"id":"example_id","properties":"example_properties"}' --json

hubspot.hubspot_update_company

Update an existing HubSpot company by ID. Provide a properties object with the fields to update (e.g., {"name": "Acme Corp", "domain": "acme.com"}). Returns the updated company.

Write write
Parameters
id, properties
Generic call 
kosmo integrations:call hubspot.hubspot_update_company '{"id":"example_id","properties":"example_properties"}' --json
Shortcut 
kosmo integrations:hubspot hubspot_update_company '{"id":"example_id","properties":"example_properties"}' --json

hubspot.hubspot_search_companies

Search HubSpot companies using filter groups and/or a text query. Use filterGroups for structured queries (e.g., domain equals "acme.com"). Use query for full-text search across searchable properties. Supports pagination with limit and after parameters.

Read read
Parameters
query, filter_groups, properties, limit, after
Generic call 
kosmo integrations:call hubspot.hubspot_search_companies '{"query":"example_query","filter_groups":"example_filter_groups","properties":"example_properties","limit":1,"after":"example_after"}' --json
Shortcut 
kosmo integrations:hubspot hubspot_search_companies '{"query":"example_query","filter_groups":"example_filter_groups","properties":"example_properties","limit":1,"after":"example_after"}' --json

hubspot.hubspot_list_companies

List companies in HubSpot CRM with cursor-based pagination and optional property selection.

Read read
Parameters
limit, after, properties
Generic call 
kosmo integrations:call hubspot.hubspot_list_companies '{"limit":1,"after":"example_after","properties":"example_properties"}' --json
Shortcut 
kosmo integrations:hubspot hubspot_list_companies '{"limit":1,"after":"example_after","properties":"example_properties"}' --json

hubspot.hubspot_create_deal

Create a new deal in HubSpot CRM. Supports dealname, amount, pipeline, dealstage, closedate, and any additional custom properties. Returns the created deal with its HubSpot ID and properties.

Write write
Parameters
dealname, amount, pipeline, dealstage, closedate, properties
Generic call 
kosmo integrations:call hubspot.hubspot_create_deal '{"dealname":"example_dealname","amount":"example_amount","pipeline":"example_pipeline","dealstage":"example_dealstage","closedate":"example_closedate","properties":"example_properties"}' --json
Shortcut 
kosmo integrations:hubspot hubspot_create_deal '{"dealname":"example_dealname","amount":"example_amount","pipeline":"example_pipeline","dealstage":"example_dealstage","closedate":"example_closedate","properties":"example_properties"}' --json

hubspot.hubspot_get_deal

Retrieve a HubSpot deal by its ID. Returns the deal's ID, properties, and associated data. Optionally specify which properties to include.

Read read
Parameters
id, properties
Generic call 
kosmo integrations:call hubspot.hubspot_get_deal '{"id":"example_id","properties":"example_properties"}' --json
Shortcut 
kosmo integrations:hubspot hubspot_get_deal '{"id":"example_id","properties":"example_properties"}' --json

hubspot.hubspot_update_deal

Update an existing HubSpot deal by ID. Provide a properties object with the fields to update (e.g., {"dealstage": "closedwon", "amount": "5000"}). Returns the updated deal.

Write write
Parameters
id, properties
Generic call 
kosmo integrations:call hubspot.hubspot_update_deal '{"id":"example_id","properties":"example_properties"}' --json
Shortcut 
kosmo integrations:hubspot hubspot_update_deal '{"id":"example_id","properties":"example_properties"}' --json

hubspot.hubspot_list_deals

List deals in HubSpot CRM with cursor-based pagination. Optionally specify properties to include and control page size. Use the "after" cursor from a previous response to fetch the next page.

Read read
Parameters
limit, after, properties
Generic call 
kosmo integrations:call hubspot.hubspot_list_deals '{"limit":1,"after":"example_after","properties":"example_properties"}' --json
Shortcut 
kosmo integrations:hubspot hubspot_list_deals '{"limit":1,"after":"example_after","properties":"example_properties"}' --json

hubspot.hubspot_create_ticket

Create a new ticket in HubSpot CRM. Supports subject, content, hs_pipeline, hs_pipeline_stage, and any additional custom properties. Returns the created ticket with its HubSpot ID and properties.

Write write
Parameters
subject, content, hs_pipeline, hs_pipeline_stage, properties
Generic call 
kosmo integrations:call hubspot.hubspot_create_ticket '{"subject":"example_subject","content":"example_content","hs_pipeline":"example_hs_pipeline","hs_pipeline_stage":"example_hs_pipeline_stage","properties":"example_properties"}' --json
Shortcut 
kosmo integrations:hubspot hubspot_create_ticket '{"subject":"example_subject","content":"example_content","hs_pipeline":"example_hs_pipeline","hs_pipeline_stage":"example_hs_pipeline_stage","properties":"example_properties"}' --json

hubspot.hubspot_get_ticket

Retrieve a HubSpot ticket by its ID. Returns the ticket's ID, properties, and associated data. Optionally specify which properties to include.

Read read
Parameters
id, properties
Generic call 
kosmo integrations:call hubspot.hubspot_get_ticket '{"id":"example_id","properties":"example_properties"}' --json
Shortcut 
kosmo integrations:hubspot hubspot_get_ticket '{"id":"example_id","properties":"example_properties"}' --json

hubspot.hubspot_update_ticket

Update an existing HubSpot ticket by ID. Provide a properties object with the fields to update (e.g., {"subject": "New subject", "hs_pipeline_stage": "2"}). Returns the updated ticket.

Write write
Parameters
id, properties
Generic call 
kosmo integrations:call hubspot.hubspot_update_ticket '{"id":"example_id","properties":"example_properties"}' --json
Shortcut 
kosmo integrations:hubspot hubspot_update_ticket '{"id":"example_id","properties":"example_properties"}' --json

hubspot.hubspot_create_association

Create an association between two HubSpot CRM objects. For example, associate a contact to a company, or a deal to a company. Specify the from/to object types (contacts, companies, deals, tickets), their IDs, and the association type. Common association types: contact_to_company, company_to_contact, deal_to_company, ticket_to_contact.

Write write
Parameters
from_type, from_id, to_type, to_id, association_type
Generic call 
kosmo integrations:call hubspot.hubspot_create_association '{"from_type":"example_from_type","from_id":"example_from_id","to_type":"example_to_type","to_id":"example_to_id","association_type":"example_association_type"}' --json
Shortcut 
kosmo integrations:hubspot hubspot_create_association '{"from_type":"example_from_type","from_id":"example_from_id","to_type":"example_to_type","to_id":"example_to_id","association_type":"example_association_type"}' --json

hubspot.hubspot_list_associations

List associations from a HubSpot CRM object to another object type. For example, list all companies associated with a specific contact. Returns the associated object IDs and association types.

Read read
Parameters
from_type, from_id, to_type
Generic call 
kosmo integrations:call hubspot.hubspot_list_associations '{"from_type":"example_from_type","from_id":"example_from_id","to_type":"example_to_type"}' --json
Shortcut 
kosmo integrations:hubspot hubspot_list_associations '{"from_type":"example_from_type","from_id":"example_from_id","to_type":"example_to_type"}' --json

hubspot.hubspot_list_owners

List HubSpot CRM owners (users). Returns owner IDs, names, and emails. Useful for assigning owners to contacts, deals, and tickets. Supports pagination with limit and after parameters.

Read read
Parameters
limit, after
Generic call 
kosmo integrations:call hubspot.hubspot_list_owners '{"limit":1,"after":"example_after"}' --json
Shortcut 
kosmo integrations:hubspot hubspot_list_owners '{"limit":1,"after":"example_after"}' --json

hubspot.hubspot_create_engagement

Create an engagement in HubSpot CRM (note, task, or meeting). Specify the type and provide the relevant properties. For notes: body (HTML content). For tasks: hs_task_body, hs_task_subject, hs_task_status. For meetings: hs_meeting_title, hs_meeting_body, hs_meeting_start_time, hs_meeting_end_time.

Write write
Parameters
type, body, timestamp, owner_id, properties
Generic call 
kosmo integrations:call hubspot.hubspot_create_engagement '{"type":"example_type","body":"example_body","timestamp":"example_timestamp","owner_id":"example_owner_id","properties":"example_properties"}' --json
Shortcut 
kosmo integrations:hubspot hubspot_create_engagement '{"type":"example_type","body":"example_body","timestamp":"example_timestamp","owner_id":"example_owner_id","properties":"example_properties"}' --json

hubspot.hubspot_list_pipelines

List HubSpot CRM pipelines for a given object type. Returns all pipelines and their stages. Commonly used for deals and tickets. Use the object type "deals" or "tickets" to get the respective pipelines.

Read read
Parameters
object_type
Generic call 
kosmo integrations:call hubspot.hubspot_list_pipelines '{"object_type":"example_object_type"}' --json
Shortcut 
kosmo integrations:hubspot hubspot_list_pipelines '{"object_type":"example_object_type"}' --json

hubspot.hubspot_list_properties

List HubSpot CRM property definitions for a given object type. Returns all properties including their name, label, type, and field type. Useful for discovering available properties for contacts, companies, deals, or tickets.

Read read
Parameters
object_type
Generic call 
kosmo integrations:call hubspot.hubspot_list_properties '{"object_type":"example_object_type"}' --json
Shortcut 
kosmo integrations:hubspot hubspot_list_properties '{"object_type":"example_object_type"}' --json

hubspot.hubspot_add_contact_to_list

Add contacts to a HubSpot marketing list. Provide either contact_ids (HubSpot vid IDs) or emails (email addresses), or both. Contacts that are already in the list are silently skipped.

Write write
Parameters
list_id, contact_ids, emails
Generic call 
kosmo integrations:call hubspot.hubspot_add_contact_to_list '{"list_id":"example_list_id","contact_ids":"example_contact_ids","emails":"example_emails"}' --json
Shortcut 
kosmo integrations:hubspot hubspot_add_contact_to_list '{"list_id":"example_list_id","contact_ids":"example_contact_ids","emails":"example_emails"}' --json

hubspot.hubspot_list_forms

List HubSpot marketing forms. Returns form IDs, names, types, and creation timestamps. Supports pagination with limit and after parameters.

Read read
Parameters
limit, after
Generic call 
kosmo integrations:call hubspot.hubspot_list_forms '{"limit":1,"after":"example_after"}' --json
Shortcut 
kosmo integrations:hubspot hubspot_list_forms '{"limit":1,"after":"example_after"}' --json

hubspot.hubspot_get_current_user

Get the authenticated HubSpot user, email, and portal information for the stored token.

Read read
Parameters
none
Generic call 
kosmo integrations:call hubspot.hubspot_get_current_user '{}' --json
Shortcut 
kosmo integrations:hubspot hubspot_get_current_user '{}' --json

Function Schemas

Use these parameter tables when building CLI payloads without calling integrations:schema first.

hubspot.hubspot_create_contact 6 parameters
Schema command 
kosmo integrations:schema hubspot.hubspot_create_contact --json
ParameterTypeRequiredDescription
first_name string no Contact first name.
last_name string no Contact last name.
email string no Contact email address.
phone string no Contact phone number.
company string no Contact company name.
properties object no Additional custom properties as key-value pairs.
hubspot.hubspot_get_contact 2 parameters
Schema command 
kosmo integrations:schema hubspot.hubspot_get_contact --json
ParameterTypeRequiredDescription
id string yes HubSpot contact ID.
properties array no List of property names to include (e.g., ["firstname","email"]).
hubspot.hubspot_update_contact 2 parameters
Schema command 
kosmo integrations:schema hubspot.hubspot_update_contact --json
ParameterTypeRequiredDescription
id string yes HubSpot contact ID to update.
properties object yes Key-value map of properties to update (e.g., {"firstname": "Jane"}).
hubspot.hubspot_search_contacts 5 parameters
Schema command 
kosmo integrations:schema hubspot.hubspot_search_contacts --json
ParameterTypeRequiredDescription
query string no Full-text search query.
filter_groups array no Array of filter groups, each containing filters with propertyName, operator, and value.
properties array no List of property names to include in results.
limit integer no Maximum number of results to return (default 10, max 100).
after string no Pagination cursor from a previous response.
hubspot.hubspot_delete_contact 1 parameters
Schema command 
kosmo integrations:schema hubspot.hubspot_delete_contact --json
ParameterTypeRequiredDescription
id string yes HubSpot contact ID to delete.
hubspot.hubspot_create_or_update_contact 6 parameters
Schema command 
kosmo integrations:schema hubspot.hubspot_create_or_update_contact --json
ParameterTypeRequiredDescription
email string yes Contact email address used for lookup.
first_name string no Contact first name.
last_name string no Contact last name.
phone string no Contact phone number.
company string no Contact company name.
properties object no Additional custom properties as key-value pairs.
hubspot.hubspot_list_contacts 3 parameters
Schema command 
kosmo integrations:schema hubspot.hubspot_list_contacts --json
ParameterTypeRequiredDescription
limit integer no Maximum number of contacts to return (default 10, max 100).
after string no Pagination cursor from a previous response.
properties array no List of contact property names to include.
hubspot.hubspot_create_company 3 parameters
Schema command 
kosmo integrations:schema hubspot.hubspot_create_company --json
ParameterTypeRequiredDescription
name string no Company name.
domain string no Company website domain.
properties object no Additional custom properties as key-value pairs.
hubspot.hubspot_get_company 2 parameters
Schema command 
kosmo integrations:schema hubspot.hubspot_get_company --json
ParameterTypeRequiredDescription
id string yes HubSpot company ID.
properties array no List of property names to include.
hubspot.hubspot_update_company 2 parameters
Schema command 
kosmo integrations:schema hubspot.hubspot_update_company --json
ParameterTypeRequiredDescription
id string yes HubSpot company ID to update.
properties object yes Key-value map of properties to update.
hubspot.hubspot_search_companies 5 parameters
Schema command 
kosmo integrations:schema hubspot.hubspot_search_companies --json
ParameterTypeRequiredDescription
query string no Full-text search query.
filter_groups array no Array of filter groups, each containing filters with propertyName, operator, and value.
properties array no List of property names to include in results.
limit integer no Maximum number of results to return (default 10, max 100).
after string no Pagination cursor from a previous response.
hubspot.hubspot_list_companies 3 parameters
Schema command 
kosmo integrations:schema hubspot.hubspot_list_companies --json
ParameterTypeRequiredDescription
limit integer no Maximum number of companies to return (default 10, max 100).
after string no Pagination cursor from a previous response.
properties array no List of company property names to include.
hubspot.hubspot_create_deal 6 parameters
Schema command 
kosmo integrations:schema hubspot.hubspot_create_deal --json
ParameterTypeRequiredDescription
dealname string no Deal name.
amount string no Deal amount.
pipeline string no Pipeline ID or internal name.
dealstage string no Deal stage ID or internal name.
closedate string no Expected close date (ISO 8601 or milliseconds timestamp).
properties object no Additional custom properties as key-value pairs.
hubspot.hubspot_get_deal 2 parameters
Schema command 
kosmo integrations:schema hubspot.hubspot_get_deal --json
ParameterTypeRequiredDescription
id string yes HubSpot deal ID.
properties array no List of property names to include.
hubspot.hubspot_update_deal 2 parameters
Schema command 
kosmo integrations:schema hubspot.hubspot_update_deal --json
ParameterTypeRequiredDescription
id string yes HubSpot deal ID to update.
properties object yes Key-value map of properties to update.
hubspot.hubspot_list_deals 3 parameters
Schema command 
kosmo integrations:schema hubspot.hubspot_list_deals --json
ParameterTypeRequiredDescription
limit integer no Maximum number of deals to return (default 10, max 100).
after string no Pagination cursor from a previous response.
properties array no List of property names to include in results.
hubspot.hubspot_create_ticket 5 parameters
Schema command 
kosmo integrations:schema hubspot.hubspot_create_ticket --json
ParameterTypeRequiredDescription
subject string yes Ticket subject / title.
content string no Ticket body content / description.
hs_pipeline string no Pipeline ID for the ticket.
hs_pipeline_stage string no Pipeline stage ID for the ticket.
properties object no Additional custom properties as key-value pairs.
hubspot.hubspot_get_ticket 2 parameters
Schema command 
kosmo integrations:schema hubspot.hubspot_get_ticket --json
ParameterTypeRequiredDescription
id string yes HubSpot ticket ID.
properties array no List of property names to include.
hubspot.hubspot_update_ticket 2 parameters
Schema command 
kosmo integrations:schema hubspot.hubspot_update_ticket --json
ParameterTypeRequiredDescription
id string yes HubSpot ticket ID to update.
properties object yes Key-value map of properties to update.
hubspot.hubspot_create_association 5 parameters
Schema command 
kosmo integrations:schema hubspot.hubspot_create_association --json
ParameterTypeRequiredDescription
from_type string yes Source object type (e.g., "contacts", "companies", "deals", "tickets").
from_id string yes Source object ID.
to_type string yes Target object type (e.g., "contacts", "companies", "deals", "tickets").
to_id string yes Target object ID.
association_type string yes Association type name (e.g., "contact_to_company", "deal_to_company").
hubspot.hubspot_list_associations 3 parameters
Schema command 
kosmo integrations:schema hubspot.hubspot_list_associations --json
ParameterTypeRequiredDescription
from_type string yes Source object type (e.g., "contacts", "companies", "deals").
from_id string yes Source object ID.
to_type string yes Target object type to list associations for (e.g., "companies", "contacts").
hubspot.hubspot_list_owners 2 parameters
Schema command 
kosmo integrations:schema hubspot.hubspot_list_owners --json
ParameterTypeRequiredDescription
limit integer no Maximum number of owners to return (default 100).
after string no Pagination cursor from a previous response.
hubspot.hubspot_create_engagement 5 parameters
Schema command 
kosmo integrations:schema hubspot.hubspot_create_engagement --json
ParameterTypeRequiredDescription
type string yes Engagement type: "notes", "tasks", or "meetings".
body string no Engagement body content (HTML for notes, plain text for tasks).
timestamp string no Engagement timestamp in ISO 8601 format.
owner_id string no HubSpot owner ID to assign the engagement to.
properties object no Additional custom properties as key-value pairs.
hubspot.hubspot_list_pipelines 1 parameters
Schema command 
kosmo integrations:schema hubspot.hubspot_list_pipelines --json
ParameterTypeRequiredDescription
object_type string yes Object type (e.g., "deals", "tickets").
hubspot.hubspot_list_properties 1 parameters
Schema command 
kosmo integrations:schema hubspot.hubspot_list_properties --json
ParameterTypeRequiredDescription
object_type string yes Object type (e.g., "contacts", "companies", "deals", "tickets").
hubspot.hubspot_add_contact_to_list 3 parameters
Schema command 
kosmo integrations:schema hubspot.hubspot_add_contact_to_list --json
ParameterTypeRequiredDescription
list_id string yes HubSpot list ID to add contacts to.
contact_ids array no Array of HubSpot contact IDs (vids) to add.
emails array no Array of email addresses to add.
hubspot.hubspot_list_forms 2 parameters
Schema command 
kosmo integrations:schema hubspot.hubspot_list_forms --json
ParameterTypeRequiredDescription
limit integer no Maximum number of forms to return (default 50).
after string no Pagination cursor from a previous response.
hubspot.hubspot_get_current_user 0 parameters
Schema command 
kosmo integrations:schema hubspot.hubspot_get_current_user --json
ParameterTypeRequiredDescription
No parameters.

Permissions

Headless calls still follow the integration read/write permission policy. Configure read/write defaults with integrations:configure. Add --force only for trusted automation that should bypass that policy.