> ## 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.
# Retrieve a course
> Lee un objeto identificado por `{courseId}`. `{courseId}` se refiere al ID de objeto interno por opción predeterminada o, de manera opcional, a cualquier valor de propiedad único especificado por el parámetro de consulta `idProperty`. Controla lo que se devuelve mediante el parámetro de consulta `properties`.
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 GET /crm/objects/2026-03/0-410/{courseId}
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/{courseId}:
get:
tags:
- Basic
summary: Recuperar un curso
description: >-
Lee un objeto identificado por `{courseId}`. `{courseId}` se refiere al
ID de objeto interno por opción predeterminada o, de manera opcional, a
cualquier valor de propiedad único especificado por el parámetro de
consulta `idProperty`. Controla lo que se devuelve mediante el parámetro
de consulta `properties`.
operationId: get-/crm/objects/2026-03/0-410/{courseId}
parameters:
- name: courseId
in: path
required: true
schema:
pattern: .+
type: string
- name: archived
in: query
description: Si se devolverán solo los resultados que se han archivado.
required: false
style: form
explode: true
schema:
type: boolean
default: false
- name: associations
in: query
description: >-
Una lista separada por comas de los tipos de objetos para los que se
recuperarán los ID asociados. Si alguna de las asociaciones
especificadas no existe, se ignorará.
required: false
style: form
explode: true
schema:
type: array
items:
type: string
- name: idProperty
in: query
description: >-
El nombre de una propiedad cuyos valores son únicos para este tipo
de objeto
required: false
style: form
explode: true
schema:
type: string
- name: properties
in: query
description: >-
Una lista separada por comas de las propiedades que se devolverán en
la respuesta. Si alguna de las propiedades especificadas no está
presente en los objetos solicitados, se ignorará.
required: false
style: form
explode: true
schema:
type: array
items:
type: string
- name: propertiesWithHistory
in: query
description: >-
Una lista separada por comas de las propiedades que se devolverán
junto con su historial de valores anteriores. Si alguna de las
propiedades especificadas no está presente en los objetos
solicitados, se ignorará.
required: false
style: form
explode: true
schema:
type: array
items:
type: string
responses:
'200':
description: successful operation
content:
application/json:
schema:
$ref: '#/components/schemas/SimplePublicObjectWithAssociations'
default:
$ref: '#/components/responses/Error'
description: ''
security:
- oauth2:
- crm.objects.courses.read
components:
schemas:
SimplePublicObjectWithAssociations:
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
associations:
type: object
additionalProperties:
$ref: '#/components/schemas/CollectionResponseAssociatedId'
description: >-
Un mapa de tipos de objetos asociados con sus ID asociados,
representados como colecciones de ID asociados.
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.
objectWriteTraceId:
type: string
description: >-
Un identificador de cadena que se usa para rastrear las operaciones
de escritura de este objeto.
properties:
type: object
additionalProperties:
type: string
description: >-
Un mapa de los nombres de las propiedades y sus valores actuales
para este objeto.
propertiesWithHistory:
type: object
additionalProperties:
type: array
items:
$ref: '#/components/schemas/ValueWithTimestamp'
description: >-
Un mapa de los nombres de las propiedades con sus valores, incluido
un historial de cambios, representados como conjuntos de valores con
marcas 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: El enlace URL para acceder a este objeto.
warnings:
type: array
description: >-
Una lista de advertencias asociadas con este objeto, cada una con
una categoría, mensaje y contexto.
items:
$ref: '#/components/schemas/PublicObjectWarning'
description: >-
Representa un objeto de CRM junto con sus propiedades, marcas de tiempo
y un conjunto de ID de objetos asociados agrupados por tipo de
asociación.
CollectionResponseAssociatedId:
required:
- results
type: object
properties:
paging:
$ref: '#/components/schemas/Paging'
results:
type: array
description: >-
Un conjunto de ID asociados, cada uno representado por un objeto
AssociatedId.
items:
$ref: '#/components/schemas/AssociatedId'
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.
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
Paging:
type: object
properties:
next:
$ref: '#/components/schemas/NextPage'
prev:
$ref: '#/components/schemas/PreviousPage'
AssociatedId:
required:
- id
- type
type: object
properties:
id:
type: string
description: >-
El identificador único del objeto asociado, representado como una
cadena.
type:
type: string
description: >-
El tipo de asociación, representado como una cadena, que indica la
naturaleza de la relación entre objetos.
example: deal_to_contact
description: Contiene el ID y el tipo de una asociación
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.
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
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}
)}