HubSpot
Interactúa con HubSpot CRM o activa workflows desde eventos de HubSpot
Configuración
Obtener usuarios
Operación
Obtener usuarios
Cuenta de HubSpot*
Seleccionar cuenta de HubSpot
Límite
Máximo de resultados (lista: 100, búsqueda: 200)
Obtener usuarios (
hubspot_get_users)Recupera todos los usuarios de la cuenta de HubSpot
Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
limit | string | No | Número de resultados que se devolverán (predeterminado: 100) |
Salida
| Parámetro | Tipo | Descripción |
|---|---|---|
users | array | Array de objetos de usuario de HubSpot |
metadata | object | Metadatos de la operación |
success | boolean | Estado de éxito de la operación |
Obtener contactos
Operación
Obtener contactos
Cuenta de HubSpot*
Seleccionar cuenta de HubSpot
ID de contacto o correo
Dejar vacío para listar todos los contactos
Propiedad de ID
Obligatorio si se usa email/domain (p. ej., "email" o "domain")
Propiedades a devolver
Lista separada por comas (p. ej., "email,firstname,lastname")
Asociaciones
Tipos de objeto separados por comas (p. ej., "companies,deals")
Límite
Máximo de resultados (lista: 100, búsqueda: 200)
After (paginación)
Cursor de paginación de la respuesta anterior
Obtener contactos (
hubspot_list_contacts)Recupera todos los contactos de la cuenta de HubSpot con soporte de paginación
Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
limit | string | No | Número máximo de resultados por página (máx. 100, valor predeterminado 100) |
after | string | No | Cursor de paginación para la página siguiente de resultados |
properties | string | No | Lista de propiedades separadas por comas que se devolverán (p. ej., "email,firstname,lastname") |
associations | string | No | Lista de tipos de objeto separados por comas para obtener los ID asociados |
Salida
| Parámetro | Tipo | Descripción |
|---|---|---|
contacts | array | Matriz de objetos de contacto de HubSpot |
paging | object | Información de paginación |
metadata | object | Metadatos de la operación |
success | boolean | Estado de éxito de la operación |
Crear contacto
Operación
Crear contacto
Cuenta de HubSpot*
Seleccionar cuenta de HubSpot
Propiedades
Objeto JSON con propiedades (p. ej., {"email": "test@example.com", "firstname": "John"})
Asociaciones
Tipos de objeto separados por comas (p. ej., "companies,deals")
Crear contacto (
hubspot_create_contact)Crea un contacto nuevo en HubSpot. Requiere al menos uno de: email, firstname o lastname
Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
properties | object | Sí | Propiedades del contacto como objeto JSON. Debe incluir al menos uno de: email, firstname o lastname |
associations | array | No | Matriz de asociaciones que crear con el contacto (p. ej., companies, deals). Cada objeto debe tener "to" (con "id") y "types" (con "associationCategory" y "associationTypeId") |
Salida
| Parámetro | Tipo | Descripción |
|---|---|---|
contact | object | Objeto de contacto de HubSpot creado |
metadata | object | Metadatos de la operación |
success | boolean | Estado de éxito de la operación |
Actualizar contacto
Operación
Actualizar contacto
Cuenta de HubSpot*
Seleccionar cuenta de HubSpot
ID de contacto o correo electrónico*
ID numérico, o correo electrónico (requiere la propiedad de ID a continuación)
Propiedad de ID
Obligatorio si se usa correo electrónico/dominio (ej., "email" o "domain")
Propiedades
Objeto JSON con propiedades (ej., {"email": "test@example.com", "firstname": "John"})
Actualizar contacto (
hubspot_update_contact)Actualiza un contacto existente en HubSpot por ID o correo electrónico
Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
contactId | string | Sí | El ID o correo electrónico del contacto a actualizar |
idProperty | string | No | Propiedad para usar como identificador único (ej., "email"). Si no se especifica, usa el ID del registro |
properties | object | Sí | Propiedades de contacto a actualizar como objeto JSON |
Salida
| Parámetro | Tipo | Descripción |
|---|---|---|
contact | object | Objeto de contacto de HubSpot actualizado |
metadata | object | Metadatos de la operación |
success | boolean | Estado de éxito de la operación |
Buscar contactos
Operación
Buscar contactos
Cuenta de HubSpot*
Seleccionar cuenta de HubSpot
Límite
Máximo de resultados (lista: 100, búsqueda: 200)
After (paginación)
Cursor de paginación de la respuesta anterior
Consulta de búsqueda
Término de búsqueda (p. ej., nombre de empresa, correo electrónico de contacto)
Grupos de filtros
Matriz JSON de grupos de filtros (p. ej., [{"filters":[{"propertyName":"email","operator":"EQ","value":"test@example.com"}]}])
Orden de clasificación
Matriz JSON de objetos de ordenación (p. ej., [{"propertyName":"createdate","direction":"DESCENDING"}])
Propiedades a devolver
Matriz JSON de propiedades (p. ej., ["email","firstname","lastname"])
Buscar contactos (
hubspot_search_contacts)Busca contactos en HubSpot mediante filtros, ordenación y consultas
Entrada
| Parameter | Type | Required | Description |
|---|---|---|---|
filterGroups | array | No | Array de grupos de filtros. Cada grupo contiene filtros con propertyName, operator y value |
sorts | array | No | Array de objetos de ordenación con propertyName y direction ("ASCENDING" o "DESCENDING") |
query | string | No | Cadena de consulta de búsqueda |
properties | array | No | Array de nombres de propiedades que se devolverán |
limit | number | No | Número máximo de resultados que se devolverán (máx. 100) |
after | string | No | Cursor de paginación para la página siguiente |
Salida
| Parameter | Type | Description |
|---|---|---|
contacts | array | Array de objetos de contacto de HubSpot coincidentes |
total | number | Número total de contactos coincidentes |
paging | object | Información de paginación |
metadata | object | Metadatos de la operación |
success | boolean | Estado de éxito de la operación |
Obtener empresas
Operación
Obtener empresas
Cuenta de HubSpot*
Seleccionar cuenta de HubSpot
ID o dominio de la empresa
Dejar vacío para listar todas las empresas
Propiedad de ID
Obligatorio si se usa email/domain (p. ej., "email" o "domain")
Propiedades a devolver
Lista separada por comas (p. ej., "email,firstname,lastname")
Asociaciones
Tipos de objeto separados por comas (p. ej., "companies,deals")
Límite
Resultados máximos (list: 100, search: 200)
After (paginación)
Cursor de paginación de la respuesta anterior
Obtener empresas (
hubspot_list_companies)Recupera todas las empresas de la cuenta de HubSpot con soporte de paginación
Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
limit | string | No | Número máximo de resultados por página (máx. 100, predeterminado 100) |
after | string | No | Cursor de paginación para la siguiente página de resultados |
properties | string | No | Lista de propiedades separadas por comas a devolver |
associations | string | No | Lista de tipos de objeto separados por comas para los que recuperar IDs asociados |
Salida
| Parámetro | Tipo | Descripción |
|---|---|---|
companies | array | Array de objetos de empresa de HubSpot |
paging | object | Información de paginación |
metadata | object | Metadatos de la operación |
success | boolean | Estado de éxito de la operación |
Crear empresa
Operación
Crear empresa
Cuenta de HubSpot*
Seleccionar cuenta de HubSpot
Propiedades
Objeto JSON con propiedades (p. ej., {"email": "test@example.com", "firstname": "John"})
Asociaciones
Tipos de objeto separados por comas (p. ej., "companies,deals")
Crear empresa (
hubspot_create_company)Crear una nueva empresa en HubSpot
Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
properties | objeto | Sí | Propiedades de la empresa como objeto JSON (p. ej., nombre, dominio, ciudad, industria) |
associations | arreglo | No | Arreglo de asociaciones para crear con la empresa |
Salida
| Parámetro | Tipo | Descripción |
|---|---|---|
company | objeto | Objeto de empresa de HubSpot creado |
metadata | objeto | Metadatos de la operación |
success | booleano | Estado de éxito de la operación |
Actualizar empresa
Operación
Actualizar empresa
Cuenta de HubSpot*
Seleccionar cuenta de HubSpot
ID de empresa o dominio*
ID numérico, o dominio (requiere la propiedad de ID a continuación)
Propiedad de ID
Obligatorio si se utiliza correo electrónico/dominio (p. ej., "email" o "domain")
Propiedades
Objeto JSON con propiedades (p. ej., {"email": "test@example.com", "firstname": "John"})
Actualizar empresa (
hubspot_update_company)Actualiza una empresa existente en HubSpot por ID o dominio
Entrada
| Parámetro | Tipo | Requerido | Descripción |
|---|---|---|---|
companyId | string | Sí | El ID o dominio de la empresa que se va a actualizar |
idProperty | string | No | Propiedad que se usará como identificador único (p. ej., "domain"). Si no se especifica, se usa el ID del registro |
properties | object | Sí | Propiedades de la empresa que se van a actualizar como objeto JSON |
Salida
| Parámetro | Tipo | Descripción |
|---|---|---|
company | object | Objeto de empresa de HubSpot actualizado |
metadata | object | Metadatos de la operación |
success | boolean | Estado de éxito de la operación |
Buscar empresas
Operación
Buscar empresas
Cuenta de HubSpot*
Selecciona una cuenta de HubSpot
Límite
Máximo de resultados (lista: 100, búsqueda: 200)
Después (paginación)
Cursor de paginación de la respuesta anterior
Consulta de búsqueda
Término de búsqueda (p. ej., nombre de la empresa, correo electrónico de contacto)
Grupos de filtros
Array JSON de grupos de filtros (p. ej., [{"filters":[{"propertyName":"email","operator":"EQ","value":"test@example.com"}]}])
Orden de clasificación
Array JSON de objetos de ordenación (p. ej., [{"propertyName":"createdate","direction":"DESCENDING"}])
Propiedades a devolver
Array JSON de propiedades (p. ej., ["email","firstname","lastname"])
Buscar empresas (
hubspot_search_companies)Busca empresas en HubSpot mediante filtros, ordenación y consultas
Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
filterGroups | array | No | Matriz de grupos de filtros. Cada grupo contiene filtros con propertyName, operator y value |
sorts | array | No | Matriz de objetos de ordenación con propertyName y direction ("ASCENDING" o "DESCENDING") |
query | string | No | Cadena de consulta de búsqueda |
properties | array | No | Matriz de nombres de propiedades que se devolverán |
limit | number | No | Número máximo de resultados que se devolverán (máx. 100) |
after | string | No | Cursor de paginación para la página siguiente |
Salida
| Parámetro | Tipo | Descripción |
|---|---|---|
companies | array | Matriz de objetos de empresa de HubSpot coincidentes |
total | number | Número total de empresas coincidentes |
paging | object | Información de paginación |
metadata | object | Metadatos de la operación |
success | boolean | Estado de éxito de la operación |
Obtener negocios
Operación
Obtener negocios
Cuenta de HubSpot*
Selecciona una cuenta de HubSpot
Propiedades que se devolverán
Lista separada por comas (p. ej., "email,firstname,lastname")
Asociaciones
Tipos de objeto separados por comas (p. ej., "companies,deals")
Límite
Máximo de resultados (list: 100, search: 200)
After (paginación)
Cursor de paginación de la respuesta anterior
Obtener negocios (
hubspot_list_deals)Recupera todos los negocios de la cuenta de HubSpot con soporte de paginación
Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
limit | string | No | Número máximo de resultados por página (máx. 100, predeterminado 100) |
after | string | No | Cursor de paginación para la siguiente página de resultados |
properties | string | No | Lista de propiedades separadas por comas que se devolverán |
associations | string | No | Lista de tipos de objeto separados por comas para los que se recuperarán los IDs asociados |
Salida
| Parámetro | Tipo | Descripción |
|---|---|---|
deals | array | Array de objetos de negocio de HubSpot |
paging | object | Información de paginación |
metadata | object | Metadatos de la operación |
success | boolean | Estado de éxito de la operación |
Herramientas adicionales
Herramientas adicionales declaradas por este bloque, incluidas las variantes dependientes de la entrada de las operaciones anteriores.
hubspot_get_contact
Recuperar un solo contacto por ID o correo electrónico desde HubSpot
Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
contactId | string | Sí | El ID o correo electrónico del contacto que se va a recuperar |
idProperty | string | No | Propiedad que se usará como identificador único (p. ej., "email"). Si no se especifica, se usa el ID del registro |
properties | string | No | Lista de propiedades que se devolverán, separadas por comas |
associations | string | No | Lista de tipos de objeto para los que se recuperarán los ID asociados, separados por comas |
Salida
| Parámetro | Tipo | Descripción |
|---|---|---|
contact | object | Objeto de contacto de HubSpot con propiedades |
metadata | object | Metadatos de la operación |
success | boolean | Estado de éxito de la operación |
hubspot_get_company
Recuperar una sola empresa por ID o dominio desde HubSpot
Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
companyId | string | Sí | El ID o dominio de la empresa que se va a recuperar |
idProperty | string | No | Propiedad que se usará como identificador único (p. ej., "domain"). Si no se especifica, se usa el ID del registro |
properties | string | No | Lista de propiedades que se devolverán, separadas por comas |
associations | string | No | Lista de tipos de objeto para los que se recuperarán los ID asociados, separados por comas |
Salida
| Parámetro | Tipo | Descripción |
|---|---|---|
company | object | Objeto de empresa de HubSpot con propiedades |
metadata | object | Metadatos de la operación |
success | boolean | Estado de éxito de la operación |
Instrucciones de uso
Integra HubSpot en tu flujo de trabajo. Gestiona contactos, empresas, negocios, tickets y otros objetos de CRM con potentes capacidades de automatización. Se puede usar en modo desencadenador para iniciar flujos de trabajo cuando se crean, eliminan o actualizan contactos.
Notas
- Categoría:
tools - Tipo:
hubspot