Platform
Kenmerken
Studio agent
Stel je agent snel samen en pas hem aan
Autonome motor
LLMs gebruiken om gesprekken en taken te begeleiden
Kennisbanken
Train uw bot met aangepaste kennisbronnen
Tabellen
Gespreksgegevens opslaan en beheren
Kanalen
Whatsapp Embleem
WhatsApp
Instagram Embleem
Instagram
Facebook Messenger logo
Messenger
Slack logo
Slack
Alle kanalen
Integraties
Hubspot logo
HubSpot
Notion
Notion
Jira-logo
Jira
Calendly logo
Calendly
Alle integraties
LLM Aanbieders
OpenAI logo
OpenAI
Anthropic logo
Anthropic
Groq logo
Groq
HuggingFace logo
Hugging Face
Alle LLMs
Oplossingen
Voor
Onderneming
Bedrijfskritische productieworkflows automatiseren
Agentschappen
Geavanceerde agentservices bieden
Ontwikkelaars
Verken een robuuste API voor agentontwikkeling
Verhalen van klanten
Ontdek van succesvolle klanten hoe Botpress bedrijven wereldwijd transformeert.
Door de industrie
E-commerce
Onderwijs
Financiën
Gastvrijheid
Alle industrieën
Per afdeling
Verkoop
Engineering
Product
ITSM
Alle afdelingen
Per gebruikssituatie
Winkelassistent
Leads genereren
Werknemerservaring
Ticketbeheer
Alle gebruikssituaties
Bronnen
Essentieel
Academy
Leer bouwen door middel van cursussen
Bibliotheek
Hulpmiddelen om uw AI-workflows te verbeteren
Blog
Inzichten en updates over Botpress en AI-agenten
gebouw
Discord
Doe mee met duizenden collega's en deel ideeën
Docs
Uitgebreide gidsen en referenties
API
Referentiemateriaal voor gebruik met externe systemen
LLM Rangschikking
Prestaties en kosten voor modelaanbieders vergelijken
Video's
Tutorials, demo's en product walkthroughs
Changelog
Blijf op de hoogte van de nieuwste Botpress
Partners
Partner worden
Word lid van ons netwerk van gecertificeerde experts
Een expert inhuren
Contact maken met partners en consultants
Docs
Onderneming
Prijzen
Inloggen
Neem contact op metAanmelden
terug naar Hub

HubSpot

v25.1.0
Installeren op uw werkruimte
Onderhouden door Envyro
  # HubSpot CRM Integration

This integration allows you to connect Botpress with HubSpot CRM, enabling various CRM operations directly through your chatbot.


## Table of Contents

1. [Introduction](#introduction)
2. [Seeing Property IDs](#seeing-property-ids)
3. [Finding Property IDs](#finding-property-ids)
4. [Actions](#actions)
    - [Contacts](#contacts)
    - [Companies](#companies)
    - [Tickets](#tickets)
    - [Deals](#deals)
    - [Other](#other)
5. [Search](#search)
    - [Search for Companies](#search-for-companies)
    - [Search for Contacts](#search-for-contacts)
    - [Search for Tickets](#search-for-tickets)
    - [Search for Deals](#search-for-deals)
6. [Using Actions](#using-actions)
    - [Contacts](#contacts-1)
    - [Companies](#companies-1)
    - [Tickets](#tickets-1)
    - [Example with Multiple Filter Groups](#example-with-multiple-filter-groups-andor-logic)
        - [Example 1: Using AND logic within a filter group](#example-1-using-and-logic-within-a-filter-group)
        - [Example 2: Using OR logic between filter groups](#example-2-using-or-logic-between-filter-groups)
        - [Example 3: Combining AND and OR logic](#example-3-combining-and-and-or-logic)
7. [Properties](#properties)

## Introduction

This guide provides instructions on using HubSpot CRM integration to manage various CRM operations, such as creating, updating, deleting, and searching for contacts, companies, and tickets.

## Seeing Property IDs

To view the internal property names for HubSpot properties, refer to the following link: [Internal HubSpot Property Names](https://community.hubspot.com/t5/APIs-Integrations/Internal-HubSpot-property-name-for-Contact-Owner/m-p/952044).

## Finding Property IDs

You can find the properties and their IDs at this link: [HubSpot Property Settings](https://app.hubspot.com/property-settings/46425249/properties?type=0-1&eschref=%2Fcontacts%2F46425249%2Fobjects%2F0-1%2Frestore).

## Actions

### Contacts

- Get a Contact
- Create a Contact
- Delete a Contact
- Update a Contact
- Search Contacts

### Companies

- Get a Company
- Create a Company
- Delete a Company
- Update a Company
- Search Companies

### Tickets

- Get a Ticket
- Create a Ticket
- Delete a Ticket
- Update a Ticket
- Search Tickets

### Deals

- Get a Deal
- Create a Deal
- Delete a Deal
- Update a Deal
- Search Deal

### Other

- Make an API Call

## Search

### Search for Companies

```json
{
  "filterGroups": [
    {
      "filters": [
        {
          "propertyName": "industry",
          "operator": "EQ",
          "value": "Technology"
        }
      ]
    }
  ],
  "sorts": [
    {
      "propertyName": "createdate",
      "direction": "DESCENDING"
    }
  ],
  "properties": ["name", "industry", "annualrevenue"],
  "limit": 100,
  "after": 0
}
```

### Search for Contacts

```json
{
  "filterGroups": [
    {
      "filters": [
        {
          "propertyName": "email",
          "operator": "EQ",
          "value": "[email protected]"
        }
      ]
    }
  ],
  "sorts": [
    {
      "propertyName": "createdate",
      "direction": "DESCENDING"
    }
  ],
  "properties": ["createdate", "firstname", "lastname", "email"],
  "limit": 100,
  "after": 0
}
```

### Search for Tickets

```json
{
  "filterGroups": [
    {
      "filters": [
        {
          "propertyName": "subject",
          "operator": "EQ",
          "value": "Support Needed"
        }
      ]
    }
  ],
  "sorts": [
    {
      "propertyName": "createdate",
      "direction": "DESCENDING"
    }
  ],
  "properties": ["createdate", "subject", "content", "status"],
  "limit": 100,
  "after": 0
}
```

#### Search for Deals

```json
{
  "filterGroups": [
    {
      "filters": [
        {
          "propertyName": "amount",
          "operator": "GT",
          "value": "10000"
        },
        {
          "propertyName": "dealstage",
          "operator": "EQ",
          "value": "closedwon"
        }
      ]
    }
  ],
  "sorts": ["amount"],
  "limit": 10
}
```

## Using Actions

### Contacts

#### Get a Contact

To get a contact, simply provide the contact ID.

```json
{
  "contactId": "12345"
}
```

#### Create a Contact

When creating a new contact, you should include at least one of the following properties: email, firstname, or lastname. It is recommended to always include email to avoid duplicate contacts in HubSpot.

```json
{
  "properties": {
    "email": "[email protected]",
    "firstname": "Milos",
    "lastname": "Arsik",
    "phone": "(226) 700-0079",
    "company": "HubSpot",
    "hubspot_owner_id": "117816668"
  }
}
```

#### Delete a Contact

To delete a contact, simply provide the contact ID.

```json
{
  "contactId": "12345"
}
```

#### Update a Contact

Perform a partial update of a contact identified by `{contactId}`. `{contactId}` refers to the internal object ID. Provided property values will be overwritten. Read-only and non-existent properties will be ignored.

```json
{
  "contactId": "12345",
  "properties": {
    "phone": "(226) 700-0080",
    "company": "HubSpot Inc."
  }
}
```

### Companies

#### Get a Company

To get a company, simply provide the company ID.

```json
{
  "companyId": "67890"
}
```

#### Create a Company

When creating a new company, include relevant properties.

```json
{
  "properties": {
    "name": "HubSpot",
    "industry": "Technology",
    "annualrevenue": "1000000"
  }
}
```

#### Delete a Company

To delete a company, simply provide the company ID.

```json
{
  "companyId": "67890"
}
```

#### Update a Company

Perform a partial update of a company identified by `{companyId}`. `{companyId}` refers to the internal object ID. Provided property values will be overwritten. Read-only and non-existent properties will be ignored.

```json
{
  "companyId": "67890",
  "properties": {
    "annualrevenue": "1500000"
  }
}
```

### Tickets

#### Get a Ticket

To get a ticket, simply provide the ticket ID.

```json
{
  "ticketId": "54321"
}
```

#### Create a Ticket

When creating a new ticket, include relevant properties.

```json
{
  "properties": {
    "subject": "Need help with integration",
    "content": "Details about the issue...",
    "status": "open"
  }
}
```

#### Delete a Ticket

To delete a ticket, simply provide the ticket ID.

```json
{
  "ticketId": "54321"
}
```

#### Update a Ticket

Perform a partial update of a ticket identified by `{ticketId}`. `{ticketId}` refers to the internal object ID. Provided property values will be overwritten. Read-only and non-existent properties will be ignored.

```json
{
  "ticketId": "54321",
  "properties": {
    "status": "closed"
  }
}
```

### Deals

#### Get a Deal

To get a deal, provide the deal ID.

```json
{
  "dealId": "32032106769"
}
```

#### Create a Deal

```json
{
  "properties": {
    "dealname": "New Deal",
    "amount": "10000",
    "dealstage": "qualifiedtobuy",
    "closedate": "2025-12-31"
  }
}
```

#### Delete a Deal

```json
{
  "dealId": "32032106769"
}
```

#### Update a Deal

```json
{
  "dealId": "32032106769",
  "properties": {
    "dealname": "Updated Deal Name",
    "amount": "15000"
  }
}
```

#### Update Deal Stage

```json
{
  "dealId": "32032106769",
  "stage": "closedwon"
}
```

## Properties

Properties are the specific fields you want to retrieve for each record. You can specify which properties to include in the response. In the examples above, properties like `createdate`, `firstname`, and `lastname` are requested. You can customize this based on the fields available in your HubSpot account.

Example:

```json
"properties": ["createdate", "firstname", "lastname", "email", "phone"]
```

### Example with Multiple Filter Groups (AND/OR logic)

#### Example 1: Using AND logic within a filter group
```json
{
  "filterGroups": [
    {
      "filters": [
        {
          "propertyName": "createdate",
          "operator": "GTE",
          "value": "1622505600000"
        },
        {
          "propertyName": "email",
          "operator": "EQ",
          "value": "[email protected]"
        }
      ]
    }
  ],
  "sorts": [
    {
      "propertyName": "createdate",
      "direction": "DESCENDING"
    }
  ],
  "properties": ["createdate", "firstname", "lastname"],
  "limit": 100,
  "after": 0
}
```

#### Example 2: Using OR logic between filter groups
```json
{
  "filterGroups": [
    {
      "filters": [
        {
          "propertyName": "createdate",
          "operator": "GTE",
          "value": "1622505600000"
        }
      ]
    },
    {
      "filters": [
        {
          "propertyName": "email",
          "operator": "EQ",
          "value": "[email protected]"
        }
      ]
    }
  ],
  "sorts": [
    {
      "propertyName": "createdate",
      "direction": "DESCENDING"
    }
  ],
  "properties": ["createdate", "firstname", "lastname"],
  "limit": 100,
  "after": 0
}
```

#### Example 3: Combining AND and OR logic
```json
{
  "filterGroups": [
    {
      "filters": [
        {
          "propertyName": "createdate",
          "operator": "GTE",
          "value": "1622505600000"
        },
        {
          "propertyName": "email",
          "operator": "EQ",
          "value": "[email protected]"
        }
      ]
    },
    {
      "filters": [
        {
          "propertyName": "firstname",
          "operator": "EQ",
          "value": "Jane"
        }
      ]
    }
  ],
  "sorts": [
    {
      "propertyName": "createdate",
      "direction": "DESCENDING"
    }
  ],
  "properties": ["createdate", "firstname", "lastname"],
  "limit": 100,
  "after": 0
}
```

Bouw beter met Botpress

Maak verbazingwekkende AI-agent-ervaringen.

Ga aan de slag - het is gratis
Pictogram van een pijl
Meer informatie op Botpress Academy

Bouw beter en sneller AI-agents met onze verzameling cursussen, handleidingen en zelfstudies.

Een expert inhuren

Neem contact op met onze gecertificeerde ontwikkelaars om een deskundige bouwer te vinden die aan jouw behoeften voldoet.

Alle systemen operationeel
SOC 2
Gecertificeerd
GDPR
Conform
© 2025
Platform
Prijzen
Studio agent
Autonome motor
Kennisbanken
Tabellen
Hub
Integraties
Kanalen
LLMs
Bronnen
Praat met Verkoop
Documentatie
Een expert inhuren
Video's
Verhalen van klanten
API referentie
Blog
Status
v12 Hulpmiddelen
Gemeenschap
Steun van de Gemeenschap
Partner worden
Word ambassadeur
Word een affiliate
Bedrijf
Over
Carrière
Nieuws & Pers
Wettelijk
Privacy
© Botpress 2025