logo

Documentation

HubSpot Agent

The HubSpot Agent is a specialized component that integrates with HubSpot CRM to provide natural language interactions with your marketing and sales data.

HubSpot Agent Component

HubSpot Agent interface and configuration options

Configuration Parameters

Required Parameters

  • Tool: HubSpot API capabilities
  • Access Token: HubSpot API token
  • CRM Resource Type: Target resource
  • Instruction Template: Agent instruction format
  • Max Input Size: Maximum request size

Output Format

{
  "results": [
    {
      "id": string,
      "type": string,
      "properties": object,
      "associations": object,
      "metadata": {
        "lastModified": string,
        "source": string
      }
    }
  ]
}

Example Usage

const hubspotAgent = new HubSpotAgent({
  tool: "hubspot-api",
  accessToken: "YOUR_ACCESS_TOKEN",
  crmResourceType: "contacts",
  instructionTemplate: "Process the following HubSpot request: {input}",
  maxInputSize: 4096
});

const result = await hubspotAgent.process({
  input: "Show me all contacts created this month"
});

Best Practices

  • Secure API token storage
  • Implement rate limiting
  • Handle API errors gracefully
  • Cache frequently accessed data
  • Monitor API usage