Companies

POST /v1/tools/hubspot/createCompany

Create a new company in HubSpot. Returns the company ID. PREREQUISITE: Call hubspot_getProperties(object_type: "companies") first to get available property names and types — do NOT guess. Properties are passed as a flat object keyed by property name. All values must be strings. Common properties: name, domain, industry, phone, city, state, country, numberofemployees, annualrevenue, lifecyclestage. For enumeration properties, use the internal value (not label) — check getProperties for valid options. For multi-select, separate values with semicolons: "value1;value2".

Parameters

Name	Type	Required	Description
values	object	required	Company properties keyed by property name. All values as strings. E.g., {"name": "Acme Corp", "domain": "acme.com", "industry": "TECHNOLOGY", "phone": "+1-555-0100"}
id_only	boolean	optional	Return only the company ID (default: true). Set to false for full response.

Flags

Name	Type	Description
id_only	boolean	Return only the company ID (default: true). Set to false for full response.

curl -X POST https://api.syncello.io/v1/tools/hubspot/createCompany \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"
  -d '{
  "values": "..."
}'

{
  "id": "612300140002"
}

POST /v1/tools/hubspot/getCompany

Get a HubSpot company by ID. Returns company properties. By default returns common properties (name, domain, industry, phone, city, state, country). Use the "properties" parameter to request specific properties. Use hubspot_getProperties(object_type: "companies") to see all available property names.

Parameters

Name	Type	Required	Description
company_id	string	required	The HubSpot company ID
return_properties	array	optional	Specific property names to return. If omitted, returns default properties.

curl -X POST https://api.syncello.io/v1/tools/hubspot/getCompany \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"
  -d '{
  "company_id": "example"
}'

{
  "id": "612300140002",
  "properties": {
    "city": "Denver",
    "country": null,
    "createdate": "2026-07-01T18:34:01.654Z",
    "domain": "acme.example.com",
    "hs_lastmodifieddate": "2026-07-01T18:34:04.642Z",
    "hs_object_id": "612300140002",
    "industry": "COMPUTER_SOFTWARE",
    "name": "Acme Corp",
    "phone": "+1-555-0111",
    "state": null
  },
  "createdAt": "2026-07-01T18:34:01.654Z",
  "updatedAt": "2026-07-01T18:34:04.642Z",
  "archived": false,
  "url": "https://app.hubspot.com/contacts/12345678/record/0-2/612300140002"
}

POST /v1/tools/hubspot/updateCompany

Update an existing HubSpot company. Pass only the properties you want to change — other properties remain unchanged. All values must be strings. PREREQUISITE: Call hubspot_getProperties(object_type: "companies") to check property names and types before updating.

Parameters

Name	Type	Required	Description
company_id	string	required	The HubSpot company ID to update
values	object	required	Properties to update, keyed by property name. All values as strings.

curl -X POST https://api.syncello.io/v1/tools/hubspot/updateCompany \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"
  -d '{
  "company_id": "example",
  "values": "..."
}'

{
  "id": "612300140002",
  "updated": true
}

POST /v1/tools/hubspot/deleteCompany

Delete a HubSpot company by ID. This moves the company to the recycling bin (recoverable for a limited time). This action cannot be easily undone.

Parameters

Name	Type	Required	Description
company_id	string	required	The HubSpot company ID to delete

curl -X POST https://api.syncello.io/v1/tools/hubspot/deleteCompany \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"
  -d '{
  "company_id": "example"
}'

{
  "deleted": true,
  "companyId": "612300140002"
}

POST /v1/tools/hubspot/searchCompanies

Search HubSpot companies using filters and sorting. Supports filtering by any property. Filter operators: EQ (equals), NEQ, LT, LTE, GT, GTE, CONTAINS_TOKEN (word search), NOT_CONTAINS_TOKEN, IN (array), NOT_IN, HAS_PROPERTY, NOT_HAS_PROPERTY, BETWEEN. Multiple filters in the same group are ANDed. Multiple filter groups are ORed. Returns up to 100 results per page with paging cursor.

Parameters

Name	Type	Required	Description
filter_groups	array	optional	Array of filter groups (ORed together). Each group has a "filters" array (ANDed together). Each filter: { propertyName: string, operator: string, value: string }. Example: [{ "filters": [{ "propertyName": "domain", "operator": "CONTAINS_TOKEN", "value": "acme" }] }]
sorts	array	optional	Sort by property. E.g., [{ "propertyName": "createdate", "direction": "DESCENDING" }]
return_properties	array	optional	Properties to include in results. Defaults to name, domain, industry.
limit	number	optional	Max results to return (1-100, default 10)
after	string	optional	Paging cursor from previous search result for next page
query	string	optional	Simple text search query (searches across default searchable properties)

curl -X POST https://api.syncello.io/v1/tools/hubspot/searchCompanies \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"

{
  "total": 1,
  "count": 1,
  "results": [
    {
      "id": "612300140002",
      "properties": {
        "city": "Denver",
        "createdate": "2026-07-01T18:34:01.654Z",
        "domain": "acme.example.com",
        "hs_lastmodifieddate": "2026-07-01T18:37:40.616Z",
        "hs_object_id": "612300140002",
        "industry": "COMPUTER_SOFTWARE",
        "name": "Acme Corp",
        "phone": "+1-555-0111"
      }
    }
  ]
}