Voyant.io

Voyant.io Hubspot API

HubSpot CRM integration: contacts, companies, deals, and engagement.

Documentation GitHub OpenAPI

Operations 10

GET /api/hubspot/status Get Hubspot Status #

POST /api/hubspot/refresh Refresh Token #

POST /api/hubspot/disconnect Disconnect Hubspot #

GET /api/hubspot/mqls Get Mqls #

GET /api/hubspot/mqls/summary Get Mql Summary #

GET /api/hubspot/mqls/trends Get Mql Trends #

GET /api/hubspot/campaigns Get Campaigns #

GET /api/hubspot/gated-content Get Gated Content #

GET /api/hubspot/context/mqls Get Mql Context #

GET /api/hubspot/context/campaigns Get Campaign Context #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this

find_apisBrowse and filter every API in the catalog.
get_api_artifactsOne API's artifacts, grouped by type.
get_openapiThe primary OpenAPI for this API.
find_similar_apisAPIs that look like this one.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This API

curl "https://apis.io/api/v1/apis/voyant-hubspot-api"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no email required.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

openapi: 3.2.0
info:
  title: VoyantIO Hubspot API
  description: '

    ## Brand Context Intelligence Platform


    VoyantIO provides AI-powered brand context management for GTM teams.


    ### Core Capabilities


    - **Context Streams** - Centralized brand knowledge that any AI tool can use

    - **Telemetry** - Visitor tracking with IP geolocation and company enrichment

    - **Signals** - Social listening across 10+ platforms: GitHub, Reddit, HackerNews, LinkedIn, Twitter/X, Discord, ProductHunt, YouTube, G2, Slack, and government sources

    - **Target Graph** - Account and contact intelligence with engagement tracking

    - **RAG** - Retrieval-augmented content generation with brand awareness


    ### Authentication


    Most endpoints require a Bearer token from Clerk authentication.

    Public endpoints (telemetry ingestion, well-known files) are clearly marked.


    ### Rate Limits


    - Telemetry ingestion: 100 req/min per IP

    - API endpoints: 1000 req/min per org

    '
  version: 1.0.0
servers:
- url: https://voice-forge-production.up.railway.app
  description: Production
tags:
- name: hubspot
  description: 'HubSpot CRM integration: contacts, companies, deals, and engagement.'
paths:
  /api/hubspot/status:
    get:
      tags:
      - hubspot
      summary: Get Hubspot Status
      description: 'Check HubSpot integration status.

        Returns whether credentials are configured and connection is working.


        Checks both org-level settings (from CRM Integration) and env var.'
      operationId: get_hubspot_status_api_hubspot_status_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
      security:
      - HTTPBearer: []
  /api/hubspot/refresh:
    post:
      tags:
      - hubspot
      summary: Refresh Token
      description: Refresh the HubSpot access token.
      operationId: refresh_token_api_hubspot_refresh_post
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
      security:
      - HTTPBearer: []
  /api/hubspot/disconnect:
    post:
      tags:
      - hubspot
      summary: Disconnect Hubspot
      description: Disconnect HubSpot integration.
      operationId: disconnect_hubspot_api_hubspot_disconnect_post
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
      security:
      - HTTPBearer: []
  /api/hubspot/mqls:
    get:
      tags:
      - hubspot
      summary: Get Mqls
      description: 'Get Marketing Qualified Leads from HubSpot.


        Returns contacts who reached MQL lifecycle stage within the specified period.'
      operationId: get_mqls_api_hubspot_mqls_get
      security:
      - HTTPBearer: []
      parameters:
      - name: days
        in: query
        required: false
        schema:
          type: integer
          maximum: 365
          minimum: 1
          description: Days to look back
          default: 30
          title: Days
        description: Days to look back
      - name: limit
        in: query
        required: false
        schema:
          type: integer
          maximum: 500
          minimum: 1
          description: Max MQLs to return
          default: 100
          title: Limit
        description: Max MQLs to return
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/hubspot/mqls/summary:
    get:
      tags:
      - hubspot
      summary: Get Mql Summary
      description: 'Get MQL summary metrics for CMO dashboard.


        Includes current count, targets, cost per MQL, and trend data.'
      operationId: get_mql_summary_api_hubspot_mqls_summary_get
      security:
      - HTTPBearer: []
      parameters:
      - name: days
        in: query
        required: false
        schema:
          type: integer
          maximum: 365
          minimum: 1
          default: 30
          title: Days
      - name: quarterly_target
        in: query
        required: false
        schema:
          type: integer
          description: Quarterly MQL target
          default: 1625
          title: Quarterly Target
        description: Quarterly MQL target
      - name: annual_target
        in: query
        required: false
        schema:
          type: integer
          description: Annual MQL target
          default: 6500
          title: Annual Target
        description: Annual MQL target
      - name: budget_spent
        in: query
        required: false
        schema:
          type: number
          description: Budget spent this period
          default: 0
          title: Budget Spent
        description: Budget spent this period
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/hubspot/mqls/trends:
    get:
      tags:
      - hubspot
      summary: Get Mql Trends
      description: 'Get MQL counts grouped by time period.


        Used for trend charts showing MQL generation over time.'
      operationId: get_mql_trends_api_hubspot_mqls_trends_get
      security:
      - HTTPBearer: []
      parameters:
      - name: days
        in: query
        required: false
        schema:
          type: integer
          maximum: 365
          minimum: 7
          default: 90
          title: Days
      - name: group_by
        in: query
        required: false
        schema:
          type: string
          pattern: ^(day|week|month)$
          default: week
          title: Group By
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/hubspot/campaigns:
    get:
      tags:
      - hubspot
      summary: Get Campaigns
      description: 'Get email campaign performance with MQL attribution.


        Returns campaigns with open rates, click rates, conversions, and MQL generation.'
      operationId: get_campaigns_api_hubspot_campaigns_get
      security:
      - HTTPBearer: []
      parameters:
      - name: days
        in: query
        required: false
        schema:
          type: integer
          maximum: 365
          minimum: 1
          default: 30
          title: Days
      - name: limit
        in: query
        required: false
        schema:
          type: integer
          maximum: 100
          minimum: 1
          default: 20
          title: Limit
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/hubspot/gated-content:
    get:
      tags:
      - hubspot
      summary: Get Gated Content
      description: 'Get gated content (forms) performance stats.


        Returns views, submissions, conversion rates, and MQL generation by content.'
      operationId: get_gated_content_api_hubspot_gated_content_get
      security:
      - HTTPBearer: []
      parameters:
      - name: days
        in: query
        required: false
        schema:
          type: integer
          maximum: 365
          minimum: 1
          default: 30
          title: Days
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/hubspot/context/mqls:
    get:
      tags:
      - hubspot
      summary: Get Mql Context
      description: 'Generate MQL context data for RAG/AI consumption.


        Returns structured data about MQL performance, trends, and insights.'
      operationId: get_mql_context_api_hubspot_context_mqls_get
      security:
      - HTTPBearer: []
      parameters:
      - name: days
        in: query
        required: false
        schema:
          type: integer
          maximum: 365
          minimum: 1
          default: 30
          title: Days
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/hubspot/context/campaigns:
    get:
      tags:
      - hubspot
      summary: Get Campaign Context
      description: 'Generate campaign context data for RAG/AI consumption.


        Returns structured data about campaign performance and insights.'
      operationId: get_campaign_context_api_hubspot_context_campaigns_get
      security:
      - HTTPBearer: []
      parameters:
      - name: days
        in: query
        required: false
        schema:
          type: integer
          maximum: 365
          minimum: 1
          default: 30
          title: Days
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
components:
  schemas:
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
            - type: string
            - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
        input:
          title: Input
        ctx:
          type: object
          title: Context
      type: object
      required:
      - loc
      - msg
      - type
      title: ValidationError
  securitySchemes:
    HTTPBearer:
      type: http
      scheme: bearer