> ## 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.
# Upsert courses
> Crea o actualiza registros identificados por un valor único de propiedad según lo especificado por el parámetro de consulta `idProperty`. El parámetro de consulta `idProperty` se refiere a una propiedad cuyos valores son únicos para el objeto.
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/upsert
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/upsert:
post:
tags:
- Batch
summary: Crear y actualizar cursos
description: >-
Crea o actualiza registros identificados por un valor único de propiedad
según lo especificado por el parámetro de consulta `idProperty`. El
parámetro de consulta `idProperty` se refiere a una propiedad cuyos
valores son únicos para el objeto.
operationId: post-/crm/objects/2026-03/0-410/batch/upsert
parameters: []
requestBody:
content:
application/json:
schema:
$ref: >-
#/components/schemas/BatchInputSimplePublicObjectBatchInputUpsert
required: true
responses:
'200':
description: successful operation
content:
application/json:
schema:
$ref: '#/components/schemas/BatchResponseSimplePublicUpsertObject'
'207':
description: multiple statuses
content:
application/json:
schema:
$ref: >-
#/components/schemas/BatchResponseSimplePublicUpsertObjectWithErrors
default:
$ref: '#/components/responses/Error'
description: ''
security:
- oauth2:
- crm.objects.courses.write
components:
schemas:
BatchInputSimplePublicObjectBatchInputUpsert:
required:
- inputs
type: object
properties:
inputs:
type: array
description: >-
Un conjunto de elementos SimplePublicObjectBatchInputUpsert, cada
uno de los cuales representa un objeto que se insertará o
actualizará. Cada elemento contiene las propiedades y los
identificadores necesarios para la operación de inserción o
actualización.
items:
$ref: '#/components/schemas/SimplePublicObjectBatchInputUpsert'
BatchResponseSimplePublicUpsertObject:
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
información adicional sobre 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 SimplePublicUpsertObject que representan
los resultados de la operación de inserción o actualización por
lotes.
items:
$ref: '#/components/schemas/SimplePublicUpsertObject'
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: >-
Representa el resultado de una operación de inserción o actualización
por lotes, que incluye el estado de la operación, las marcas de tiempo y
una lista de objetos creados o actualizados con éxito.
BatchResponseSimplePublicUpsertObjectWithErrors:
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 errores que se produjeron durante la operación por
lotes, cada uno representado como un StandardError.
items:
$ref: '#/components/schemas/StandardError'
links:
type: object
additionalProperties:
type: string
description: >-
Un mapa de nombres de enlaces a URI asociados que contienen
documentación sobre la operación por lotes.
numErrors:
type: integer
description: >-
El número total de errores que se produjeron 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 resultados de la operación de inserción/actualización
por lotes, cada uno representado como SimplePublicUpsertObject.
items:
$ref: '#/components/schemas/SimplePublicUpsertObject'
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 response from a batch upsert operation, including the
status, timestamps, successfully processed objects, and any errors that
occurred during processing.
SimplePublicObjectBatchInputUpsert:
required:
- id
- properties
type: object
properties:
id:
type: string
description: Una cadena que representa el identificador único del objeto del CRM.
idProperty:
type: string
description: >-
Una cadena que especifica el nombre de una propiedad cuyos valores
son únicos para este tipo de objeto.
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 que representan las
propiedades del objeto del CRM. Cada clave es un nombre de propiedad
y cada valor es el valor de la propiedad.
description: >-
Representa un objeto utilizado en operaciones de inserción o
actualización por lotes, que contiene el identificador único de un
objeto, sus propiedades y, opcionalmente, el nombre de la propiedad
única y un ID de rastro de escritura.
SimplePublicUpsertObject:
required:
- archived
- createdAt
- id
- new
- properties
- updatedAt
type: object
properties:
archived:
type: boolean
description: Indica si el objeto está archivado. Es un valor booleano.
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.
new:
type: boolean
description: Indica si el objeto se creó recientemente. Es un valor booleano.
objectWriteTraceId:
type: string
description: >-
Un ID de seguimiento para rastrear la operación de escritura que
creó o actualizó este objeto.
properties:
type: object
additionalProperties:
type: string
description: >-
Un mapa de nombres de propiedades con sus valores, que representa
los datos del objeto.
propertiesWithHistory:
type: object
additionalProperties:
type: array
items:
$ref: '#/components/schemas/ValueWithTimestamp'
description: >-
Un mapa de nombres de propiedades con conjuntos de sus valores
históricos, cada entrada contiene un valor y una 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: La URL del objeto en HubSpot.
warnings:
type: array
description: >-
Un conjunto de advertencias relacionadas con el objeto, cada una con
una categoría, mensaje y contexto.
items:
$ref: '#/components/schemas/PublicObjectWarning'
description: Representa un objeto del CRM que se creó o actualizó
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
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}
)}