> ## Documentation Index
> Fetch the complete documentation index at: https://developers.hubspot.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.
---
id: 779de1be-bb8d-4a5e-8a0b-bd56ab273366
---
# Create a batch of courses
> Create a batch of objects
export const ScopesList = ({scopes = [], description = "This API requires one of the following scopes:"}) => {
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: Courses
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: >-
Use the courses API to create and manage CRM records that represent
information about a structured program or series of lessons, trainings, or
educational modules. Identify the course object type with its object type ID
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: Batch create courses
description: Create a batch of objects
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: >-
An array of objects, each containing the properties and associations
for a CRM object to be created. Each item in the array is of type
SimplePublicObjectBatchInputForCreate.
items:
$ref: '#/components/schemas/SimplePublicObjectBatchInputForCreate'
BatchResponseSimplePublicObject:
required:
- completedAt
- results
- startedAt
- status
type: object
properties:
completedAt:
type: string
description: >-
The date and time when the batch operation was completed, in ISO
8601 format.
format: date-time
links:
type: object
additionalProperties:
type: string
description: >-
A map of link names to associated URIs, providing additional
resources or information related to the batch operation.
requestedAt:
type: string
description: >-
The date and time when the batch operation was requested, in ISO
8601 format.
format: date-time
results:
type: array
description: >-
An array of SimplePublicObject items representing the results of the
batch operation.
items:
$ref: '#/components/schemas/SimplePublicObject'
startedAt:
type: string
description: >-
The date and time when the batch operation started, in ISO 8601
format.
format: date-time
status:
type: string
description: >-
The current status of the batch operation. Valid values include
'PENDING', 'PROCESSING', 'CANCELED', and 'COMPLETE'.
enum:
- CANCELED
- COMPLETE
- PENDING
- PROCESSING
description: A public object batch response object
BatchResponseSimplePublicObjectWithErrors:
required:
- completedAt
- results
- startedAt
- status
type: object
properties:
completedAt:
type: string
description: >-
The date and time when the batch operation was completed, in ISO
8601 format.
format: date-time
errors:
type: array
description: >-
An array of StandardError objects detailing any errors that occurred
during the batch operation.
items:
$ref: '#/components/schemas/StandardError'
links:
type: object
additionalProperties:
type: string
description: >-
A map of link names to associated URIs providing additional
information about the batch operation.
numErrors:
type: integer
description: The number of errors encountered during the batch operation.
format: int32
requestedAt:
type: string
description: >-
The date and time when the batch operation was requested, in ISO
8601 format.
format: date-time
results:
type: array
description: >-
An array of SimplePublicObject items representing the results of the
batch operation.
items:
$ref: '#/components/schemas/SimplePublicObject'
startedAt:
type: string
description: >-
The date and time when the batch operation started, in ISO 8601
format.
format: date-time
status:
type: string
description: >-
The current status of the batch operation. Valid values include
'PENDING', 'PROCESSING', 'CANCELED', and '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: >-
An array of associations that define relationships between the
objects being created and other existing objects in the CRM.
items:
$ref: '#/components/schemas/PublicAssociationsForObject'
objectWriteTraceId:
type: string
description: >-
A string used to trace the write operation for debugging or logging
purposes.
properties:
type: object
additionalProperties:
type: string
description: >-
An object containing key-value pairs where keys are property names
and values are the corresponding property values for the CRM objects
to be created.
description: >-
An input object that contains a collection of objects to be created
together in a batch.
SimplePublicObject:
required:
- archived
- createdAt
- id
- properties
- updatedAt
type: object
properties:
archived:
type: boolean
description: A boolean indicating whether this object is archived.
archivedAt:
type: string
description: The date and time when this object was archived, in ISO 8601 format.
format: date-time
createdAt:
type: string
description: The date and time when this object was created, in ISO 8601 format.
format: date-time
id:
type: string
description: The unique identifier for this object, represented as a string.
objectWriteTraceId:
type: string
description: >-
A string identifier used for tracing the write operations on this
object.
properties:
type: object
additionalProperties:
type: string
description: >-
A map of property names to their values, where each value is a
string.
propertiesWithHistory:
type: object
additionalProperties:
type: array
items:
$ref: '#/components/schemas/ValueWithTimestamp'
description: >-
A map of property names to their historical values, where each value
is an array of objects containing the value and timestamp.
updatedAt:
type: string
description: >-
The date and time when this object was last updated, in ISO 8601
format.
format: date-time
url:
type: string
description: A string representing the URL associated with this object.
warnings:
type: array
description: >-
An array of warnings related to this object, where each warning
contains a category, message, and context.
items:
$ref: '#/components/schemas/PublicObjectWarning'
description: A simple public object.
StandardError:
required:
- category
- context
- errors
- links
- message
- status
type: object
properties:
category:
type: string
description: A string that categorizes the error.
context:
type: object
additionalProperties:
type: array
items:
type: string
description: >-
An object containing additional context about the error condition.
Each key maps to an array of strings.
errors:
type: array
description: >-
An array of ErrorDetail objects providing further details about the
error.
items:
$ref: '#/components/schemas/ErrorDetail'
id:
type: string
description: A string representing the unique identifier for the error.
links:
type: object
additionalProperties:
type: string
description: >-
An object mapping link names to associated URIs, which contain
documentation about the error or recommended remediation steps.
message:
type: string
description: A string containing a human-readable message describing the error.
status:
type: string
description: A string indicating the status of the error.
subCategory:
type: object
properties: {}
description: An object providing more specific details about the error category.
description: >-
Represents a standard error response in the HubSpot API, providing
detailed information about an error that occurred during an API request.
Error:
required:
- category
- correlationId
- message
type: object
properties:
category:
type: string
description: The error category, providing a general classification of the error.
context:
type: object
additionalProperties:
type: array
items:
type: string
description: >-
Context about the error condition, represented as an object with
additional properties that are arrays of strings.
example: >-
{invalidPropertyName=[propertyValue], missingScopes=[scope1,
scope2]}
correlationId:
type: string
description: >-
A unique identifier for the request. Include this value with any
error reports or support tickets. Format: UUID.
format: uuid
example: aeb5f871-7f07-4993-9211-075dc63e7cbf
errors:
type: array
description: >-
Further information about the error, provided as an array of
ErrorDetail objects.
items:
$ref: '#/components/schemas/ErrorDetail'
links:
type: object
additionalProperties:
type: string
description: >-
A map of link names to associated URIs containing documentation
about the error or recommended remediation steps.
message:
type: string
description: >-
A human readable message describing the error along with remediation
steps where appropriate.
example: An error occurred
subCategory:
type: string
description: >-
A specific category that contains more specific detail about the
error.
description: >-
Represents an error response returned by the API when an operation
fails. This component is used in various endpoints to provide detailed
information about the error encountered.
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: >-
An array of association specifications, each detailing the type of
association between the objects. Each item in the array is a
reference to the 'AssociationSpec' schema.
items:
$ref: '#/components/schemas/AssociationSpec'
ValueWithTimestamp:
required:
- sourceType
- timestamp
- value
type: object
properties:
sourceId:
type: string
description: A string representing the unique identifier of the source.
sourceLabel:
type: string
description: A string providing a label or description for the source.
sourceType:
type: string
description: >-
A string indicating the type of source from which the value
originated.
timestamp:
type: string
description: The date and time when the value was recorded, in ISO 8601 format.
format: date-time
updatedByUserId:
type: integer
description: >-
An integer representing the ID of the user who last updated the
value.
format: int32
value:
type: string
description: A string representing the data value.
description: Property model that includes timestamp.
PublicObjectWarning:
required:
- category
- context
- message
type: object
properties:
category:
type: string
description: A string representing the category of the warning.
context:
type: object
additionalProperties:
type: string
description: >-
An object providing additional context for the warning, with string
properties.
message:
type: string
description: A string containing the warning message.
ErrorDetail:
required:
- message
type: object
properties:
code:
type: string
description: >-
The status code associated with the error detail. This is a string
property.
context:
type: object
additionalProperties:
type: array
items:
type: string
description: >-
Context about the error condition, represented as an object with
additional properties that are arrays of strings.
example: '{missingScopes=[scope1, scope2]}'
in:
type: string
description: >-
The name of the field or parameter in which the error was found.
This is a string property.
message:
type: string
description: >-
A human readable message describing the error along with remediation
steps where appropriate. This is a required string property.
subCategory:
type: string
description: >-
A specific category that contains more specific detail about the
error. This is a string property.
description: >-
Represents detailed information about an error that occurred in the API.
This component is used to provide additional context and specifics about
errors, typically as part of an error response.
PublicObjectId:
required:
- id
type: object
properties:
id:
type: string
description: >-
The unique identifier for the CRM object. It is a string value that
is required for identifying objects in API requests.
description: Contains the Id of a Public Object
AssociationSpec:
required:
- associationCategory
- associationTypeId
type: object
properties:
associationCategory:
type: string
description: >-
The category of the association, indicating its origin or purpose.
Valid values include 'HUBSPOT_DEFINED', 'USER_DEFINED',
'INTEGRATOR_DEFINED', and 'WORK'.
enum:
- HUBSPOT_DEFINED
- INTEGRATOR_DEFINED
- USER_DEFINED
- WORK
associationTypeId:
type: integer
description: >-
An integer representing the unique identifier for the type of
association.
format: int32
description: >-
Defines the type, direction, and details of the relationship between two
CRM objects.
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}
)}