> ## 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.
# Create a batch of courses
> Crea un lote de objetos
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/batch/create
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/batch/create:
post:
tags:
- Batch
summary: Crear cursos en lote
description: Crea un lote de objetos
operationId: post-/crm/objects/2026-03/0-410/batch/create
parameters: []
requestBody:
content:
application/json:
schema:
$ref: >-
#/components/schemas/BatchInputSimplePublicObjectBatchInputForCreate
required: true
responses:
'201':
description: successful operation
content:
application/json:
schema:
$ref: '#/components/schemas/BatchResponseSimplePublicObject'
'207':
description: multiple statuses
content:
application/json:
schema:
$ref: '#/components/schemas/BatchResponseSimplePublicObjectWithErrors'
default:
$ref: '#/components/responses/Error'
description: ''
security:
- oauth2:
- crm.objects.courses.write
components:
schemas:
BatchInputSimplePublicObjectBatchInputForCreate:
required:
- inputs
type: object
properties:
inputs:
type: array
description: >-
Un conjunto de objetos, cada uno con las propiedades y asociaciones
de un objeto del CRM que se va a crear. Cada elemento del conjunto
es del tipo SimplePublicObjectBatchInputForCreate.
items:
$ref: '#/components/schemas/SimplePublicObjectBatchInputForCreate'
BatchResponseSimplePublicObject:
required:
- completedAt
- results
- startedAt
- status
type: object
properties:
completedAt:
type: string
description: >-
La fecha y hora en que se completó la operación por lotes, en
formato ISO 8601.
format: date-time
links:
type: object
additionalProperties:
type: string
description: >-
Un mapa de nombres de enlaces a URI asociados que proporciona
recursos o información adicionales relacionados con la operación por
lotes.
requestedAt:
type: string
description: >-
La fecha y la hora en que se solicitó la operación por lotes, en
formato ISO 8601.
format: date-time
results:
type: array
description: >-
Un conjunto de elementos SimplePublicObject que representan los
resultados de la operación por lotes.
items:
$ref: '#/components/schemas/SimplePublicObject'
startedAt:
type: string
description: >-
La fecha y la hora en que comenzó la operación por lotes, en formato
ISO 8601.
format: date-time
status:
type: string
description: >-
El estado actual de la operación por lotes. Los valores válidos son
"PENDING", "PROCESSING", "CANCELED" y "COMPLETE".
enum:
- CANCELED
- COMPLETE
- PENDING
- PROCESSING
description: Un objeto de respuesta de lote de objetos públicos
BatchResponseSimplePublicObjectWithErrors:
required:
- completedAt
- results
- startedAt
- status
type: object
properties:
completedAt:
type: string
description: >-
La fecha y hora en que se completó la operación por lotes, en
formato ISO 8601.
format: date-time
errors:
type: array
description: >-
Un conjunto de objetos StandardError que detalla los errores que se
produjeron durante la operación por lotes.
items:
$ref: '#/components/schemas/StandardError'
links:
type: object
additionalProperties:
type: string
description: >-
Un mapa de nombres de enlaces a URI asociados que proporcionan
información adicional sobre la operación por lotes.
numErrors:
type: integer
description: El número de errores encontrados durante la operación por lotes.
format: int32
requestedAt:
type: string
description: >-
La fecha y la hora en que se solicitó la operación por lotes, en
formato ISO 8601.
format: date-time
results:
type: array
description: >-
Un conjunto de elementos SimplePublicObject que representan los
resultados de la operación por lotes.
items:
$ref: '#/components/schemas/SimplePublicObject'
startedAt:
type: string
description: >-
La fecha y la hora en que comenzó la operación por lotes, en formato
ISO 8601.
format: date-time
status:
type: string
description: >-
El estado actual de la operación por lotes. Los valores válidos son
"PENDING", "PROCESSING", "CANCELED" y "COMPLETE".
enum:
- CANCELED
- COMPLETE
- PENDING
- PROCESSING
description: >-
Represents the result of a batch operation on CRM objects, including the
processing status, batch results, timestamps, and a list of any errors
encountered during the operation.
SimplePublicObjectBatchInputForCreate:
required:
- associations
- properties
type: object
properties:
associations:
type: array
description: >-
Una serie de asociaciones que definen las relaciones entre los
objetos que se están creando y otros objetos existentes en el CRM.
items:
$ref: '#/components/schemas/PublicAssociationsForObject'
objectWriteTraceId:
type: string
description: >-
Una cadena que se usa para rastrear la operación de escritura con
fines de depuración o registro.
properties:
type: object
additionalProperties:
type: string
description: >-
Un objeto que contiene pares clave-valor, donde las claves son
nombres de propiedades y los valores son los valores de propiedad
correspondientes para los objetos del CRM que se van a crear.
description: >-
Un objeto de entrada que contiene una colección de objetos que se
crearán juntos en un lote.
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.
StandardError:
required:
- category
- context
- errors
- links
- message
- status
type: object
properties:
category:
type: string
description: Una cadena que clasifica el error.
context:
type: object
additionalProperties:
type: array
items:
type: string
description: >-
Un objeto que contiene contexto adicional sobre la condición del
error. Cada clave se asigna a un conjunto de cadenas.
errors:
type: array
description: >-
Un conjunto de objetos ErrorDetail que proporciona más detalles
sobre el error.
items:
$ref: '#/components/schemas/ErrorDetail'
id:
type: string
description: Una cadena que representa el identificador único del error.
links:
type: object
additionalProperties:
type: string
description: >-
Un objeto que asigna nombres de enlaces a URI asociados, los cuales
contienen documentación sobre el error o los pasos de solución
recomendados.
message:
type: string
description: >-
Una cadena que contiene un mensaje comprensible para los humanos que
describe el error.
status:
type: string
description: Una cadena que indica el estado del error.
subCategory:
type: object
properties: {}
description: >-
Un objeto que proporciona detalles más específicos sobre la
categoría del error.
description: >-
Representa una respuesta de error estándar en la API de HubSpot, que
proporciona información detallada sobre un error que ocurrió durante una
solicitud a la API.
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
PublicAssociationsForObject:
required:
- to
- types
type: object
properties:
to:
$ref: '#/components/schemas/PublicObjectId'
types:
type: array
description: >-
Un conjunto de especificaciones de asociaciones, cada una de las
cuales detalla el tipo de asociación entre los objetos. Cada
elemento del conjunto es una referencia al esquema
"AssociationSpec".
items:
$ref: '#/components/schemas/AssociationSpec'
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.
PublicObjectId:
required:
- id
type: object
properties:
id:
type: string
description: >-
El identificador único del objeto del CRM. Es un valor de cadena que
se necesita para identificar objetos en las solicitudes a la API.
description: Contiene el ID de un objeto público
AssociationSpec:
required:
- associationCategory
- associationTypeId
type: object
properties:
associationCategory:
type: string
description: >-
La categoría de la asociación, que indica su origen o propósito. Los
valores válidos incluyen "HUBSPOT_DEFINED", "USER_DEFINED",
"INTEGRATOR_DEFINED" y "WORK".
enum:
- HUBSPOT_DEFINED
- INTEGRATOR_DEFINED
- USER_DEFINED
- WORK
associationTypeId:
type: integer
description: >-
Un número entero que representa el identificador único para el tipo
de asociación.
format: int32
description: >-
Define el tipo, la dirección y los detalles de la relación entre dos
objetos del CRM.
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}
)}