> ## Documentation Index
> Fetch the complete documentation index at: https://developers.hubspot.es/docs/llms.txt
> Use this file to discover all available pages before exploring further.
# Search for objects
> Encontrar objetos usando una consulta de búsqueda
export const ScopesList = ({scopes = [], description = "Esta API requiere uno de los siguientes ámbitos:"}) => {
if (!scopes || scopes.length === 0) {
return null;
}
const sortedScopes = scopes.sort((a, b) => a.localeCompare(b));
return
;
};
## OpenAPI
````yaml specs/2026-03/crm-courses-v2026-03.json POST /crm/objects/2026-03/0-410/search
openapi: 3.0.1
info:
title: Cursos
description: Basepom for all HubSpot Projects
version: 2026-03
x-hubspot-product-tier-requirements:
marketing: FREE
sales: FREE
service: FREE
cms: FREE
commerce: FREE
crmHub: FREE
dataHub: FREE
x-hubspot-introduction: >-
Usa la API de cursos para crear y gestionar registros CRM que representan
información sobre un programa estructurado o una serie de lecciones,
actividades de formación o módulos educativos. Identifica el tipo de objeto
de cursos con su ID de tipo de objeto 0-410
servers:
- url: https://api.hubapi.com
security: []
tags:
- name: Advanced
- name: Basic
- name: Batch
- name: Search
paths:
/crm/objects/2026-03/0-410/search:
post:
tags:
- Search
summary: Buscar cursos
description: Encontrar objetos usando una consulta de búsqueda
operationId: post-/crm/objects/2026-03/0-410/search
parameters: []
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/PublicObjectSearchRequest'
required: true
responses:
'200':
description: successful operation
content:
application/json:
schema:
$ref: >-
#/components/schemas/CollectionResponseWithTotalSimplePublicObject
default:
$ref: '#/components/responses/Error'
description: ''
security:
- oauth2:
- crm.objects.courses.read
components:
schemas:
PublicObjectSearchRequest:
required:
- after
- filterGroups
- limit
- properties
- sorts
type: object
properties:
after:
type: string
description: >-
Una cadena que representa el token del cursor de paginación para
obtener el siguiente conjunto de resultados.
filterGroups:
type: array
description: >-
Un conjunto de objetos FilterGroup que definen los criterios para
filtrar los resultados de la búsqueda.
items:
$ref: '#/components/schemas/FilterGroup'
limit:
type: integer
description: >-
Un número entero que especifica el número máximo de resultados a
devolver.
format: int32
properties:
type: array
description: >-
Un conjunto de cadenas que indica qué propiedades de los objetos
deben devolverse en los resultados de la búsqueda.
items:
type: string
query:
type: string
description: >-
Una cadena que representa la consulta de búsqueda para filtrar los
objetos.
sorts:
type: array
description: >-
Un conjunto de cadenas que especifican los campos por los que se
deben ordenar los resultados de la búsqueda.
items:
type: string
description: Describe una solicitud de búsqueda
CollectionResponseWithTotalSimplePublicObject:
required:
- results
- total
type: object
properties:
paging:
$ref: '#/components/schemas/Paging'
results:
type: array
description: >-
Un array que contiene los objetos públicos simples que forman parte
de la colección.
items:
$ref: '#/components/schemas/SimplePublicObject'
total:
type: integer
description: >-
Un número entero que representa el número total de objetos públicos
simples en la colección.
format: int32
description: >-
Representa una lista de objetos simples devueltos de una solicitud a la
API, junto con el total de objetos disponibles.
FilterGroup:
required:
- filters
type: object
properties:
filters:
type: array
description: >-
Un conjunto de objetos del filtro que definen los criterios para
filtrar datos. Cada filtro especifica una propiedad, un operador y
un valor o intervalo de valores para comparar.
items:
$ref: '#/components/schemas/Filter'
Paging:
type: object
properties:
next:
$ref: '#/components/schemas/NextPage'
prev:
$ref: '#/components/schemas/PreviousPage'
SimplePublicObject:
required:
- archived
- createdAt
- id
- properties
- updatedAt
type: object
properties:
archived:
type: boolean
description: Un booleano que indica si este objeto está archivado.
archivedAt:
type: string
description: La fecha y hora en que se archivó este objeto, en formato ISO 8601.
format: date-time
createdAt:
type: string
description: La fecha y hora en que se creó este objeto, en formato ISO 8601.
format: date-time
id:
type: string
description: El identificador único de este objeto, representado como una cadena.
objectWriteTraceId:
type: string
description: >-
Un identificador de cadena que se usa para rastrear las operaciones
de escritura en este objeto.
properties:
type: object
additionalProperties:
type: string
description: >-
Un mapa de nombres de propiedades y sus valores, donde cada valor es
una cadena.
propertiesWithHistory:
type: object
additionalProperties:
type: array
items:
$ref: '#/components/schemas/ValueWithTimestamp'
description: >-
Un mapa de nombres de propiedades con sus valores históricos, donde
cada valor es un conjuntos de objetos que contiene el valor y la
marca de tiempo.
updatedAt:
type: string
description: >-
La fecha y hora de la última actualización de este objeto, en
formato ISO 8601.
format: date-time
url:
type: string
description: Una cadena que representa la URL asociada a este objeto.
warnings:
type: array
description: >-
Un conjunto de advertencias relacionadas con este objeto, donde cada
advertencia contiene una categoría, mensaje y contexto.
items:
$ref: '#/components/schemas/PublicObjectWarning'
description: Un objeto público simple.
Error:
required:
- category
- correlationId
- message
type: object
properties:
category:
type: string
description: >-
La categoría del error, que proporciona una clasificación general
del error.
context:
type: object
additionalProperties:
type: array
items:
type: string
description: >-
Contexto sobre la condición de error, representado como un objeto
con propiedades adicionales que son secuencias de cadenas.
example: >-
{invalidPropertyName=[propertyValue], missingScopes=[scope1,
scope2]}
correlationId:
type: string
description: >-
Un identificador único de la solicitud. Incluye este valor en
cualquier informe de error o ticket de asistencia. Formato: UUID.
format: uuid
example: aeb5f871-7f07-4993-9211-075dc63e7cbf
errors:
type: array
description: >-
Más información sobre el error, proporcionada como un conjunto de
objetos ErrorDetail.
items:
$ref: '#/components/schemas/ErrorDetail'
links:
type: object
additionalProperties:
type: string
description: >-
Un mapa de nombres de enlaces a URI asociadas que contienen
documentación sobre el error o los pasos recomendados para
solucionarlo.
message:
type: string
description: >-
Un mensaje legible en el que se describa el error y los pasos para
solucionarlo, si procede.
example: An error occurred
subCategory:
type: string
description: >-
Una categoría específica que contiene detalles más concretos acerca
del error.
description: >-
Representa una respuesta de error que devuelve la API cuando una
operación falla. Este componente se usa en varios puntos de terminación
para dar información detallada sobre el error que se encontró.
example:
message: Invalid input (details will vary based on the error)
correlationId: aeb5f871-7f07-4993-9211-075dc63e7cbf
category: VALIDATION_ERROR
links:
knowledge-base: https://www.hubspot.com/products/service/knowledge-base
Filter:
required:
- operator
- propertyName
type: object
properties:
highValue:
type: string
description: >-
Una cadena que representa el límite superior de un intervalo al
filtrar con operadores basados en intervalos como "BETWEEN".
operator:
type: string
description: >-
Una cadena que especifica el operador de comparación que se usará en
el filtro. Los valores válidos incluyen 'EQ', 'NEQ', 'LT', 'LTE',
'GT', 'GTE', 'BETWEEN', 'IN', 'NOT_IN', 'HAS_PROPERTY',
'NOT_HAS_PROPERTY', 'CONTAINS_TOKEN' y 'NOT_CONTAINS_TOKEN'.
enum:
- BETWEEN
- CONTAINS_TOKEN
- EQ
- GT
- GTE
- HAS_PROPERTY
- IN
- LT
- LTE
- NEQ
- NOT_CONTAINS_TOKEN
- NOT_HAS_PROPERTY
- NOT_IN
propertyName:
type: string
description: >-
El nombre de la propiedad a la que se aplica el filtro. Es una
cadena que representa el campo que se filtrará.
value:
type: string
description: >-
Una cadena que representa el valor específico con el que se compara
la propiedad propertyName al usar el filtro.
values:
type: array
description: >-
Un conjunto de cadenas que representan varios valores que se
compararán con propertyName al usar operadores como "IN" o "NOT_IN".
items:
type: string
description: >-
Define una condición única para buscar objetos del CRM especificando la
propiedad con la cual filtrar, el operador que se usará (como igual a,
mayor que o contiene) y los valores con los que comparar.
NextPage:
required:
- after
type: object
properties:
after:
type: string
description: >-
Un token de cadena que se usa como cursor para obtener la siguiente
página de resultados.
link:
type: string
description: >-
Una URL que proporciona un enlace directo a la siguiente página de
resultados.
description: >-
Especifica la información de paginación necesaria para obtener el
siguiente conjunto de resultados en una respuesta paginada de la API
PreviousPage:
required:
- before
type: object
properties:
before:
type: string
description: >-
Un token de cadena que se usa para identificar la posición de la
página anterior en la secuencia de paginación.
link:
type: string
description: >-
Una URL que proporciona un enlace directo para acceder a la página
de resultados anterior.
description: >-
especifica la información de paginación necesaria para obtener el
conjunto anterior de resultados en una respuesta paginada de la API
ValueWithTimestamp:
required:
- sourceType
- timestamp
- value
type: object
properties:
sourceId:
type: string
description: Una cadena que representa el identificador único de la fuente.
sourceLabel:
type: string
description: Una cadena que proporciona una etiqueta o descripción de la fuente.
sourceType:
type: string
description: >-
Una cadena que indica el tipo de fuente de la que se originó el
valor.
timestamp:
type: string
description: La fecha y hora en que se registró el valor, en formato ISO 8601.
format: date-time
updatedByUserId:
type: integer
description: >-
Un número entero que representa el ID del usuario que actualizó el
valor por última vez.
format: int32
value:
type: string
description: Una cadena que representa el valor de los datos.
description: Modelo de propiedad que incluye marca de tiempo.
PublicObjectWarning:
required:
- category
- context
- message
type: object
properties:
category:
type: string
description: Una cadena que representa la categoría de la advertencia.
context:
type: object
additionalProperties:
type: string
description: >-
Un objeto que proporciona contexto adicional para la advertencia,
con propiedades de cadena.
message:
type: string
description: Una cadena que contiene un mensaje de advertencia.
ErrorDetail:
required:
- message
type: object
properties:
code:
type: string
description: >-
El código de estado asociado con el detalle del error. Esta es una
propiedad de cadena.
context:
type: object
additionalProperties:
type: array
items:
type: string
description: >-
Contexto sobre la condición de error, representado como un objeto
con propiedades adicionales que son secuencias de cadenas.
example: '{missingScopes=[scope1, scope2]}'
in:
type: string
description: >-
El nombre del campo o parámetro en el que se encontró el error. Esta
es una propiedad de cadena.
message:
type: string
description: >-
Un mensaje comprensible para los humanos que describe el error,
junto con los pasos de solución cuando corresponda. Esta es una
propiedad de cadena obligatoria.
subCategory:
type: string
description: >-
Una categoría específica que contiene detalles más concretos sobre
el error. Esta es una propiedad de cadena.
description: >-
Representa información detallada sobre un error que ocurrió en la API.
Este componente se usa para dar contexto adicional y detalles
específicos sobre los errores, normalmente como parte de una respuesta
de error.
responses:
Error:
description: An error occurred.
content:
'*/*':
schema:
$ref: '#/components/schemas/Error'
securitySchemes:
oauth2:
type: oauth2
flows:
authorizationCode:
authorizationUrl: https://app.hubspot.com/oauth/authorize
tokenUrl: https://api.hubapi.com/oauth/v1/token
scopes:
crm.objects.commercepayments.read: ''
crm.objects.courses.read: ''
crm.objects.courses.write: ''
oauth: ''
````
{product.name} -
{product.level}
)}