HubSpot CRM

Methods (16)

• searchContacts

  read

  Search HubSpot contacts by name, email, company, or free-text query.

  Input schema

  {
    "type": "object",
    "properties": {
      "query": {
        "type": "string",
        "description": "Free-text search across contact fields"
      },
      "email": {
        "type": "string",
        "description": "Exact email match"
      },
      "name": {
        "type": "string",
        "description": "First name contains (partial match)"
      },
      "company": {
        "type": "string",
        "description": "Company name contains (partial match)"
      },
      "properties": {
        "type": "array",
        "description": "Property names to return (default: email, firstname, lastname, phone, company, jobtitle)"
      },
      "limit": {
        "type": "number",
        "description": "Max results (default 100, max 200)"
      },
      "after": {
        "type": "string",
        "description": "Pagination cursor from previous response"
      }
    },
    "additionalProperties": false
  }

• searchCompanies

  read

  Search HubSpot companies by name, domain, industry, or free-text query.

  Input schema

  {
    "type": "object",
    "properties": {
      "query": {
        "type": "string",
        "description": "Free-text search"
      },
      "name": {
        "type": "string",
        "description": "Company name contains (partial match)"
      },
      "domain": {
        "type": "string",
        "description": "Exact domain match (e.g., \"formentera.com\")"
      },
      "industry": {
        "type": "string",
        "description": "Exact industry match"
      },
      "properties": {
        "type": "array",
        "description": "Property names to return"
      },
      "limit": {
        "type": "number",
        "description": "Max results (default 100, max 200)"
      },
      "after": {
        "type": "string",
        "description": "Pagination cursor"
      }
    },
    "additionalProperties": false
  }

• searchDeals

  read

  Search HubSpot deals by stage, pipeline, owner, or free-text query.

  Input schema

  {
    "type": "object",
    "properties": {
      "query": {
        "type": "string",
        "description": "Free-text search across deal fields"
      },
      "dealstage": {
        "type": "string",
        "description": "Deal stage ID (use getDealPipelines to discover stage IDs)"
      },
      "pipeline": {
        "type": "string",
        "description": "Pipeline ID"
      },
      "owner": {
        "type": "string",
        "description": "HubSpot owner ID"
      },
      "properties": {
        "type": "array",
        "description": "Property names to return"
      },
      "limit": {
        "type": "number",
        "description": "Max results (default 100, max 200)"
      },
      "after": {
        "type": "string",
        "description": "Pagination cursor"
      }
    },
    "additionalProperties": false
  }

• search

  read

  Generic CRM search for any object type with custom filters.

  Input schema

  {
    "type": "object",
    "properties": {
      "objectType": {
        "type": "string",
        "description": "Object type: contacts, companies, deals, tickets, products, quotes, etc."
      },
      "query": {
        "type": "string",
        "description": "Free-text search"
      },
      "filters": {
        "type": "array",
        "description": "Array of {propertyName, operator, value}. Operators: EQ, NEQ, LT, LTE, GT, GTE, BETWEEN, IN, CONTAINS_TOKEN, HAS_PROPERTY"
      },
      "properties": {
        "type": "array",
        "description": "Property names to return"
      },
      "sorts": {
        "type": "array",
        "description": "Array of {propertyName, direction}"
      },
      "limit": {
        "type": "number",
        "description": "Max results (default 100, max 200)"
      },
      "after": {
        "type": "string",
        "description": "Pagination cursor"
      }
    },
    "required": [
      "objectType"
    ],
    "additionalProperties": false
  }

• getAssociations

  read

  Get associations between CRM objects (e.g., contact → companies, deal → contacts).

  Required paramsfromObjectTypeobjectIdtoObjectType
  Input schema

  {
    "type": "object",
    "properties": {
      "fromObjectType": {
        "type": "string",
        "description": "Source object type (contacts, companies, deals, tickets)"
      },
      "objectId": {
        "type": "string",
        "description": "Source object ID"
      },
      "toObjectType": {
        "type": "string",
        "description": "Target object type"
      }
    },
    "required": [
      "fromObjectType",
      "objectId",
      "toObjectType"
    ],
    "additionalProperties": false
  }

• createDeal

  write

  Create a new deal. Requires dealname and dealstage properties.

  Required paramsproperties
  Input schema

  {
    "type": "object",
    "properties": {
      "properties": {
        "type": "object",
        "description": "Deal properties. Required: dealname, dealstage. Optional: pipeline, amount, closedate, hubspot_owner_id."
      }
    },
    "required": [
      "properties"
    ],
    "additionalProperties": false
  }

• getDealPipelines

  read

  List all deal pipelines and their stages. Use this to discover stage IDs before filtering deals.

• getProperties

  read

  List all available properties for a CRM object type. Use this to discover field names before searching.

  Required paramsobjectType
  Input schema

  {
    "type": "object",
    "properties": {
      "objectType": {
        "type": "string",
        "description": "Object type: contacts, companies, deals, tickets"
      }
    },
    "required": [
      "objectType"
    ],
    "additionalProperties": false
  }

• searchTickets

  read

• getContact

  read

• getCompany

  read

• getDeal

  read

• getTicket

  read

• createContact

  write

• createCompany

  write

• updateDeal

  write