Skip to content

HubSpot: Courses schemas

37 HubSpot schemas with complete fields and constraints.

← Courses operations · All schemas

Archive batch objects — courses batch Delete Courses — request body — body

FieldTypePresenceDescription and constraints
$objectRootRepresents a batch input payload containing a list of simple public object IDs. This component is used when performing batch operations on multiple objects within HubSpot.
inputsarrayRequired within parentAn array of SimplePublicObjectId objects. Each object in the array contains the ID of a CRM object to be processed in the batch operation.
inputs[]ModelEach itemExpand Archive a batch of deals by ID — request body — body inputs item

Referenced models: Archive a batch of deals by ID — request body — body inputs item

Batch create objects — courses batch Create Courses — request body — body

FieldTypePresenceDescription and constraints
$objectRootRepresents a batch input for creating multiple simple public objects in a single request. This component is used to streamline the process of adding new objects to a HubSpot account by allowing multiple entries to be created at once.
inputsarrayRequired within parentAn array of SimplePublicObjectBatchInputForCreate objects, each containing the properties and associations necessary to create a single CRM object.
inputs[]ModelEach itemExpand Batch create objects — courses batch Create Courses — request body — body inputs item

Referenced models: Batch create objects — courses batch Create Courses — request body — body inputs item

Batch create objects — courses batch Create Courses — request body — body inputs item

FieldTypePresenceDescription and constraints
$objectRootAn input object that contains a collection of objects to be created together in a batch.
associationsarrayRequired within parentAn array of associations to be created for the objects. Each association specifies the relationship between objects, using the PublicAssociationsForObject schema.
associations[]ModelEach itemExpand Create — courses create Course — request body — body associations item
objectWriteTraceIdstringOptionalA unique identifier for tracing the creation request.
propertiesobjectRequired within parentKey-value pairs representing the properties of the object.
Additional keys: see wildcard field
properties.*stringAdditional keys

Referenced models: Create — courses create Course — request body — body associations item

Batch upsert objects — courses batch Upsert Courses — request body — body

FieldTypePresenceDescription and constraints
$objectRootRepresents a batch input operation for upserting simple public objects in HubSpot. This component is used to process multiple upsert operations in a single request, improving efficiency and performance.
inputsarrayRequired within parentAn array of objects, each representing a single CRM object to be upserted. Each object must conform to the SimplePublicObjectBatchInputUpsert schema.
inputs[]ModelEach itemExpand Batch upsert objects — courses batch Upsert Courses — request body — body inputs item

Referenced models: Batch upsert objects — courses batch Upsert Courses — request body — body inputs item

Batch upsert objects — courses batch Upsert Courses — request body — body inputs item

FieldTypePresenceDescription and constraints
$objectRootRepresents an object used in batch upsert operations, containing an object’s unique identifier, its properties, and optionally the unique property name and a write trace ID.
idstringRequired within parentA string representing the unique identifier of the CRM object.
idPropertystringOptionalThe name of a property whose values are unique for this object
objectWriteTraceIdstringOptionalA string identifier used for tracing the write operation of the object.
propertiesobjectRequired within parentAn object containing key-value pairs where keys are property names and values are the corresponding property values. These properties define the attributes of the CRM object.
Additional keys: see wildcard field
properties.*stringAdditional keys

Batch upsert objects — courses.batchUpsertCourses — response body — status: CANCELED, COMPLETE, PENDING, PROCESSING results item

FieldTypePresenceDescription and constraints
$objectRootRepresents a CRM object that has either been created or updated (upserted)
archivedbooleanRequired within parentA boolean indicating whether this object has been archived.
archivedAtstringOptionalThe date and time when this object was archived, in ISO 8601 format.
Format: date-time
createdAtstringRequired within parentThe date and time when this object was created, in ISO 8601 format.
Format: date-time
idstringRequired within parentThe unique identifier for this object, represented as a string.
newbooleanRequired within parentA boolean indicating whether this object is newly created.
objectWriteTraceIdstringOptionalAn identifier used for tracing the creation or update request of the object.
propertiesobjectRequired within parentA map of property names to their values, where each value is a string.
Additional keys: see wildcard field
properties.*stringAdditional keys
propertiesWithHistoryobjectOptionalA map of property names to arrays of historical values, each containing a value and its associated timestamp.
Additional keys: see wildcard field
propertiesWithHistory.*arrayAdditional keys
propertiesWithHistory.*[]ModelEach itemExpand Read — courses get Course — response body — properties With History value item
updatedAtstringRequired within parentThe date and time when this object was last updated, in ISO 8601 format.
Format: date-time
urlstringOptionalThe URL of this object, represented as a string.
warningsarrayOptionalAn array of warnings related to this object, each containing a category, message, and context.
warnings[]ModelEach itemExpand Create a company — response body — warnings item

Referenced models: Create a company — response body — warnings item, Read — courses get Course — response body — properties With History value item

Batch upsert objects — courses.batchUpsertCourses — response body — status: CANCELED, COMPLETE, PENDING, PROCESSING — Courses Batch Response Simple Public Upsert Object

FieldTypePresenceDescription and constraints
$objectRootRepresents the result of a batch upsert operation, including the operation’s status, timestamps, and a list of successfully created or updated objects.
completedAtstringRequired within parentThe date and time when the batch operation was completed, in ISO 8601 format.
Format: date-time
linksobjectOptionalA map of link names to associated URIs that provide additional information about the batch operation.
Additional keys: see wildcard field
links.*stringAdditional keys
requestedAtstringOptionalThe date and time when the batch operation was requested, in ISO 8601 format.
Format: date-time
resultsarrayRequired within parentAn array of SimplePublicUpsertObject items, representing the individual results of the upsert operation for each object in the batch.
results[]ModelEach itemExpand Batch upsert objects — courses.batchUpsertCourses — response body — status: CANCELED, COMPLETE, PENDING, PROCESSING results item
startedAtstringRequired within parentThe date and time when the batch operation started, in ISO 8601 format.
Format: date-time
statusstringRequired within parentThe current status of the batch operation. Valid values include 'PENDING', 'PROCESSING', 'CANCELED', and 'COMPLETE'.
Known values: CANCELED, COMPLETE, PENDING, PROCESSING

Referenced models: Batch upsert objects — courses.batchUpsertCourses — response body — status: CANCELED, COMPLETE, PENDING, PROCESSING results item

Batch upsert objects — courses.batchUpsertCourses — response body — status: CANCELED, COMPLETE, PENDING, PROCESSING — Courses Batch Response Simple Public Upsert Object With Errors

FieldTypePresenceDescription and constraints
$objectRootRepresents the response from a batch upsert operation, including the status, timestamps, successfully processed objects, and any errors that occurred during processing.
completedAtstringRequired within parentThe date and time when the batch operation was completed, in ISO 8601 format.
Format: date-time
errorsarrayOptionalAn array of StandardError objects, each detailing an error encountered during the batch operation.
errors[]ModelEach itemExpand Read batch objects — courses.batchGetCourses — response body — status: CANCELED, COMPLETE, PENDING, PROCESSING errors item
linksobjectOptionalA map of link names to associated URIs, providing additional context or resources related to the batch operation.
Additional keys: see wildcard field
links.*stringAdditional keys
numErrorsJSONOptional
numErrors (anyOf 1)integerAlternativeThe total number of errors encountered during the batch operation.
Format: int32
numErrors (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
requestedAtstringOptionalThe date and time when the batch operation was requested, in ISO 8601 format.
Format: date-time
resultsarrayRequired within parentAn array of SimplePublicUpsertObject items, each representing the result of an individual upsert operation within the batch.
results[]ModelEach itemExpand Batch upsert objects — courses.batchUpsertCourses — response body — status: CANCELED, COMPLETE, PENDING, PROCESSING results item
startedAtstringRequired within parentThe date and time when the batch operation started, in ISO 8601 format.
Format: date-time
statusstringRequired within parentThe current status of the batch operation. Valid values include 'PENDING', 'PROCESSING', 'CANCELED', and 'COMPLETE'.
Known values: CANCELED, COMPLETE, PENDING, PROCESSING

Referenced models: Read batch objects — courses.batchGetCourses — response body — status: CANCELED, COMPLETE, PENDING, PROCESSING errors item, Batch upsert objects — courses.batchUpsertCourses — response body — status: CANCELED, COMPLETE, PENDING, PROCESSING results item

Create — courses create Course — request body — body

FieldTypePresenceDescription and constraints
$objectRootIs the input object used to create a new CRM object, containing the properties to be set and optional associations to link the new record with other CRM objects.
associationsarrayRequired within parentAn array of associations for the object, where each association specifies the related object and the types of associations. Each item in the array is a 'PublicAssociationsForObject' object.
associations[]ModelEach itemExpand Create — courses create Course — request body — body associations item
propertiesobjectRequired within parentAn object containing key-value pairs representing the properties of the CRM object. Each key is a property name, and each value is the property's value, both represented as strings.
Additional keys: see wildcard field
properties.*stringAdditional keys

Referenced models: Create — courses create Course — request body — body associations item

Create — courses create Course — request body — body associations item

FieldTypePresenceDescription and constraints
$objectRootRepresents the associations for a specific object in HubSpot, detailing the types of associations and the related objects involved.
toModelRequired within parentExpand Create — courses create Course — request body — body associations item to
typesarrayRequired within parentAn array of association specifications, each defining the category and type of association between the objects.
types[]ModelEach itemExpand Create — courses create Course — request body — body associations item types item

Referenced models: Create — courses create Course — request body — body associations item types item, Create — courses create Course — request body — body associations item to

Create — courses create Course — request body — body associations item to

FieldTypePresenceDescription and constraints
$objectRootContains the Id of a Public Object
idstringRequired within parentThe unique identifier for the object.

Create — courses create Course — request body — body associations item types item

FieldTypePresenceDescription and constraints
$objectRootDefines the type, direction, and details of the relationship between two CRM objects.
associationCategorystringRequired within parentThe category of the association, indicating its origin or definition. Valid values include 'HUBSPOT_DEFINED', 'USER_DEFINED', 'INTEGRATOR_DEFINED', and 'WORK'.
One of: HUBSPOT_DEFINED, INTEGRATOR_DEFINED, USER_DEFINED, WORK
associationTypeIdintegerRequired within parentAn integer representing the unique identifier for the type of association.
Format: int32

Create — courses create Course — response body

FieldTypePresenceDescription and constraints
$objectRootA simple public object.
archivedbooleanRequired within parentA boolean indicating whether this object is archived.
archivedAtstringOptionalThe date and time when this object was archived, in ISO 8601 format.
Format: date-time
createdAtstringRequired within parentThe date and time when this object was created, in ISO 8601 format.
Format: date-time
idstringRequired within parentThe unique identifier for this object, represented as a string.
objectWriteTraceIdstringOptionalAn identifier used for tracing the creation or update request of the object.
propertiesobjectRequired within parentA map of property names to their values, where each value is a string.
Additional keys: see wildcard field
properties.*stringAdditional keys
propertiesWithHistoryobjectOptionalA map of property names to arrays of historical values, each containing a value and a timestamp.
Additional keys: see wildcard field
propertiesWithHistory.*arrayAdditional keys
propertiesWithHistory.*[]ModelEach itemExpand Read — courses get Course — response body — properties With History value item
updatedAtstringRequired within parentThe date and time when this object was last updated, in ISO 8601 format.
Format: date-time
urlstringOptionalA string representing the URL of this object.
warningsarrayOptionalAn array of warnings related to this object, each containing a category, message, and context.
warnings[]ModelEach itemExpand Create a company — response body — warnings item

Referenced models: Create a company — response body — warnings item, Read — courses get Course — response body — properties With History value item

GDPR Delete — courses gdpr Delete — request body — body

FieldTypePresenceDescription and constraints
$objectRootAn input that contains the information required to process a public GDPR data deletion request.
idPropertystringOptionalThe name of a property whose values are unique for this object
objectIdstringRequired within parentThe unique identifier of the object to be deleted.

List associations — courses get Associations By To Object Type — response body

FieldTypePresenceDescription and constraints
$objectRootRepresents a paginated collection of objects that are associated with multiple labels, including the results and pagination details. This component is used when retrieving associated objects with specific labels in a forward-paging manner.
pagingModelOptionalExpand List — courses get Courses — response body — paging
resultsarrayRequired within parentAn array of objects, each representing an association with multiple labels. Each object includes details about the associated object and its labels.
results[]ModelEach itemExpand List associations — courses get Associations By To Object Type — response body — results item

Referenced models: List — courses get Courses — response body — paging, List associations — courses get Associations By To Object Type — response body — results item

List associations — courses get Associations By To Object Type — response body — results item

FieldTypePresenceDescription and constraints
$objectRootRepresents an object that is associated with multiple other objects, with optional context.
associationTypesarrayRequired within parentAn array of association specifications, each including a label and type information. This defines the types of associations between the objects.
associationTypes[]ModelEach itemExpand List associations — courses get Associations By To Object Type — response body — results item association Types item
toObjectIdstringRequired within parentThe ID of the object to which the associations are made.

Referenced models: List associations — courses get Associations By To Object Type — response body — results item association Types item

List associations — courses get Associations By To Object Type — response body — results item association Types item

FieldTypePresenceDescription and constraints
$objectRootDefines the type, direction, and details of the relationship between two CRM objects.
categorystringRequired within parentThe category of the association, which can be HUBSPOT_DEFINED, USER_DEFINED, or INTEGRATOR_DEFINED.
Known values: HUBSPOT_DEFINED, INTEGRATOR_DEFINED, USER_DEFINED, WORK
fromObjectTypeIdstringOptionalThe object type ID of the source object in the association.
labelstringOptionalA human-readable name for the association.
toObjectTypeIdstringOptionalThe object type ID of the target object in the association.
typeIdJSONRequired within parent
typeId (anyOf 1)integerAlternativeThe unique identifier for the type of association.
Format: int32
typeId (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$

List — courses get Courses — response body

FieldTypePresenceDescription and constraints
$objectRootRepresents a paginated collection response that includes simple public objects with their associations. This component is used to handle the results and pagination details when retrieving a list of objects from the API.
pagingModelOptionalExpand List — courses get Courses — response body — paging
resultsarrayRequired within parentAn array of SimplePublicObjectWithAssociations, each representing a CRM object with its properties and associated data.
results[]ModelEach itemExpand Read — courses get Course — response body

Referenced models: List — courses get Courses — response body — paging, Read — courses get Course — response body

List — courses get Courses — response body — paging

FieldTypePresenceDescription and constraints
$objectRootPaging information for forward-only pagination. Contains the next page reference when more results are available; omitted or empty on the last page.
nextModelOptionalExpand List — courses get Courses — response body — paging next

Referenced models: List — courses get Courses — response body — paging next

List — courses get Courses — response body — paging next

FieldTypePresenceDescription and constraints
$objectRootSpecifies the paging information needed to retrieve the next set of results in a paginated API response
afterstringRequired within parentA string token used as a cursor to fetch the next page of results.
linkstringOptionalA URL string that provides a direct link to the next page of results.

Read batch objects — courses batch Get Courses — request body — body

FieldTypePresenceDescription and constraints
$objectRootSpecifies the input for reading a batch of CRM objects, including arrays of object IDs, requested property names (with optional history), and an optional unique identifying property.
idPropertystringOptionalWhen using a custom unique value property to retrieve records, the name of the property. Do not include this parameter if retrieving by record ID.
inputsarrayRequired within parentAn array of SimplePublicObjectId objects, each representing an object ID to be included in the batch read operation.
inputs[]ModelEach itemExpand Archive a batch of deals by ID — request body — body inputs item
propertiesarrayRequired within parentAn array of strings specifying the properties to be returned in the response. If any specified properties are not present on the requested objects, they will be ignored.
properties[]stringEach item
propertiesWithHistoryarrayRequired within parentAn array of strings specifying the properties to be returned along with their history of previous values. If any specified properties are not present on the requested objects, they will be ignored.
propertiesWithHistory[]stringEach item

Referenced models: Archive a batch of deals by ID — request body — body inputs item

Read batch objects — courses.batchGetCourses — response body — status: CANCELED, COMPLETE, PENDING, PROCESSING errors item

FieldTypePresenceDescription and constraints
$objectRootRepresents a standard error response in the HubSpot API, providing detailed information about an error that occurred during an API request.
categorystringRequired within parentA string that categorizes the error.
contextobjectRequired within parentAn object containing additional context about the error, with each property being an array of strings.
Additional keys: see wildcard field
context.*arrayAdditional keys
context.*[]stringEach item
errorsarrayRequired within parentAn array of ErrorDetail objects providing further information about the error.
errors[]ModelEach itemExpand Batch insert events — response body — errors item errors item
idstringOptionalA string representing the unique identifier for this error.
linksobjectRequired within parentAn object mapping link names to associated URIs that contain documentation about the error or recommended remediation steps.
Additional keys: see wildcard field
links.*stringAdditional keys
messagestringRequired within parentA string containing a human-readable message describing the error.
statusstringRequired within parentA string indicating the status of the error.
subCategoryobjectOptionalAn object providing more specific categorization of the error.

Referenced models: Batch insert events — response body — errors item errors item

Read batch objects — courses.batchGetCourses — response body — status: CANCELED, COMPLETE, PENDING, PROCESSING — Courses Batch Response Simple Public Object

FieldTypePresenceDescription and constraints
$objectRootA public object batch response object
completedAtstringRequired within parentThe date and time when the batch operation was completed, in ISO 8601 format.
Format: date-time
linksobjectOptionalA map of link names to associated URIs, providing additional information or actions related to the batch operation.
Additional keys: see wildcard field
links.*stringAdditional keys
requestedAtstringOptionalThe date and time when the batch operation was requested, in ISO 8601 format.
Format: date-time
resultsarrayRequired within parentAn array of SimplePublicObject items representing the results of the batch operation.
results[]ModelEach itemExpand Create — courses create Course — response body
startedAtstringRequired within parentThe date and time when the batch operation started, in ISO 8601 format.
Format: date-time
statusstringRequired within parentThe current status of the batch operation. Valid values include 'PENDING', 'PROCESSING', 'CANCELED', and 'COMPLETE'.
Known values: CANCELED, COMPLETE, PENDING, PROCESSING

Referenced models: Create — courses create Course — response body

Read batch objects — courses.batchGetCourses — response body — status: CANCELED, COMPLETE, PENDING, PROCESSING — Courses Batch Response Simple Public Object With Errors

FieldTypePresenceDescription and constraints
$objectRootRepresents 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.
completedAtstringRequired within parentThe date and time when the batch operation was completed, in ISO 8601 format.
Format: date-time
errorsarrayOptionalAn array of standard errors that occurred during the batch operation.
errors[]ModelEach itemExpand Read batch objects — courses.batchGetCourses — response body — status: CANCELED, COMPLETE, PENDING, PROCESSING errors item
linksobjectOptionalA map of link names to associated URIs providing additional information or actions related to the batch operation.
Additional keys: see wildcard field
links.*stringAdditional keys
numErrorsJSONOptional
numErrors (anyOf 1)integerAlternativeThe number of errors encountered during the batch operation.
Format: int32
numErrors (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
requestedAtstringOptionalThe date and time when the batch operation was requested, in ISO 8601 format.
Format: date-time
resultsarrayRequired within parentAn array of simple public objects that were processed in the batch operation.
results[]ModelEach itemExpand Create — courses create Course — response body
startedAtstringRequired within parentThe date and time when the batch operation started, in ISO 8601 format.
Format: date-time
statusstringRequired within parentThe current status of the batch operation. Valid values include 'PENDING', 'PROCESSING', 'CANCELED', and 'COMPLETE'.
Known values: CANCELED, COMPLETE, PENDING, PROCESSING

Referenced models: Read batch objects — courses.batchGetCourses — response body — status: CANCELED, COMPLETE, PENDING, PROCESSING errors item, Create — courses create Course — response body

Read — courses get Course — response body

FieldTypePresenceDescription and constraints
$objectRootRepresents a CRM object along with its properties, timestamps, and a set of associated object IDs grouped by association type.
archivedbooleanRequired within parentA boolean indicating whether this object is archived.
archivedAtstringOptionalThe date and time when this object was archived, in ISO 8601 format.
Format: date-time
associationsobjectOptionalA map of associated object types to their associated IDs, each represented by a CollectionResponseAssociatedId object.
Additional keys: see wildcard field
associations.*ModelAdditional keysExpand Read — courses get Course — response body — associations value
createdAtstringRequired within parentThe date and time when this object was created, in ISO 8601 format.
Format: date-time
idstringRequired within parentThe unique identifier for this object, represented as a string.
objectWriteTraceIdstringOptionalAn identifier used for tracing the write operations on the object.
propertiesobjectRequired within parentA map of property names to their current values, where each value is a string.
Additional keys: see wildcard field
properties.*stringAdditional keys
propertiesWithHistoryobjectOptionalA map of property names to arrays of their historical values, each represented by a ValueWithTimestamp object.
Additional keys: see wildcard field
propertiesWithHistory.*arrayAdditional keys
propertiesWithHistory.*[]ModelEach itemExpand Read — courses get Course — response body — properties With History value item
updatedAtstringRequired within parentThe date and time when this object was last updated, in ISO 8601 format.
Format: date-time
urlstringOptionalA string representing the URL of this object.
warningsarrayOptionalAn array of warnings related to this object, each represented by a PublicObjectWarning object.
warnings[]ModelEach itemExpand Create a company — response body — warnings item

Referenced models: Create a company — response body — warnings item, Read — courses get Course — response body — associations value, Read — courses get Course — response body — properties With History value item

Read — courses get Course — response body — associations value

FieldTypePresenceDescription and constraints
$objectRootRepresents a collection of associated IDs returned by an API request, including pagination details for navigating through the results.
pagingModelOptionalExpand Search — courses search Courses — response body — paging
resultsarrayRequired within parentAn array of associated IDs, each represented by an object that includes the ID and type of the association.
results[]ModelEach itemExpand Read — courses get Course — response body — associations value results item

Referenced models: Read — courses get Course — response body — associations value results item, Search — courses search Courses — response body — paging

Read — courses get Course — response body — associations value results item

FieldTypePresenceDescription and constraints
$objectRootContains the id and type of an association
idstringRequired within parentA string representing the unique identifier for the association.
typestringRequired within parentA string indicating the type of association, which categorizes the relationship between objects.

Read — courses get Course — response body — properties With History value item

FieldTypePresenceDescription and constraints
$objectRootProperty model that includes timestamp.
sourceIdstringOptionalA string representing the unique identifier of the source from which the value was obtained.
sourceLabelstringOptionalA string providing a human-readable label for the source of the value.
sourceTypestringRequired within parentA string indicating the type of source from which the value was obtained. This property is required.
timestampstringRequired within parentThe date and time when the value was recorded, in ISO 8601 format.
Format: date-time
updatedByUserIdJSONOptional
updatedByUserId (anyOf 1)integerAlternativeAn integer representing the ID of the user who last updated the value.
Format: int32
updatedByUserId (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
valuestringRequired within parentThe value associated with the timestamp. It is a string representing the data captured at a specific point in time.

Search — courses search Courses — request body — body

FieldTypePresenceDescription and constraints
$objectRootDescribes a search request
afterstringRequired within parentA string representing the paging cursor token for pagination. It is used to retrieve the next set of results after the current page.
filterGroupsarrayRequired within parentAn array of filter groups used to define the search criteria. Each filter group contains filters that determine which CRM objects are included in the search results.
filterGroups[]ModelEach itemExpand Search — courses search Courses — request body — body filter Groups item
limitintegerRequired within parentAn integer indicating the maximum number of results to return per page. This property controls the pagination of the search results.
Format: int32
propertiesarrayRequired within parentAn array of strings specifying the properties of the CRM objects to be returned in the search results. If a specified property is not present on the objects, it will be ignored.
properties[]stringEach item
querystringOptionalA string representing a search query to filter the CRM objects. This is an optional field that can be used to perform a text-based search.
sortsarrayRequired within parentAn array of strings specifying the sorting order of the search results. Each string represents a property by which the results should be sorted.
sorts[]stringEach item

Referenced models: Search — courses search Courses — request body — body filter Groups item

Search — courses search Courses — request body — body filter Groups item

FieldTypePresenceDescription and constraints
$objectRootRepresents a group of filters used to query data within HubSpot. This component is used to define criteria for filtering records in various API endpoints.
filtersarrayRequired within parentAn array of filter objects that define the criteria for the search. Each filter specifies a property, an operator, and a value to filter by.
filters[]ModelEach itemExpand Search — courses search Courses — request body — body filter Groups item filters item

Referenced models: Search — courses search Courses — request body — body filter Groups item filters item

Search — courses search Courses — request body — body filter Groups item filters item

FieldTypePresenceDescription and constraints
$objectRootDefines a single condition for searching CRM objects, specifying the property to filter on, the operator to use (such as equals, greater than, or contains), and the value(s) to compare against.
highValuestringOptionalAn optional string value used in range queries to specify the upper bound.
operatorstringRequired within parentThe operator used to compare the property and value(s). Valid operators include 'EQ', 'NEQ', 'LT', 'LTE', 'GT', 'GTE', 'BETWEEN', 'IN', 'NOT_IN', 'HAS_PROPERTY', 'NOT_HAS_PROPERTY', 'CONTAINS_TOKEN', and 'NOT_CONTAINS_TOKEN'.
One of: BETWEEN, CONTAINS_TOKEN, EQ, GT, GTE, HAS_PROPERTY, IN, LT, LTE, NEQ, NOT_CONTAINS_TOKEN, NOT_HAS_PROPERTY, NOT_IN
propertyNamestringRequired within parentThe name of the property to filter on. This is a string value.
valuestringOptionalThe value to compare against the property specified. This is a string value.
valuesarrayOptionalAn array of string values used for filters that require multiple values, such as 'IN' or 'NOT_IN' operators.
values[]stringEach item

Search — courses search Courses — response body

FieldTypePresenceDescription and constraints
$objectRootRepresents a list of simple objects returned from an API request, along with the total count of objects available.
pagingModelOptionalExpand Search — courses search Courses — response body — paging
resultsarrayRequired within parentAn array containing the simple public objects returned in the current response.
results[]ModelEach itemExpand Create — courses create Course — response body
totalJSONRequired within parent
total (anyOf 1)integerAlternativeThe number of available results
Format: int32
total (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$

Referenced models: Search — courses search Courses — response body — paging, Create — courses create Course — response body

Search — courses search Courses — response body — paging

FieldTypePresenceDescription and constraints
$objectRootRepresents the pagination information for navigating through a list of results in the API. It provides details on how to access the previous or next set of results.
nextModelOptionalExpand List — courses get Courses — response body — paging next
prevModelOptionalExpand Search — courses search Courses — response body — paging prev

Referenced models: List — courses get Courses — response body — paging next, Search — courses search Courses — response body — paging prev

Search — courses search Courses — response body — paging prev

FieldTypePresenceDescription and constraints
$objectRootspecifies the paging information needed to retrieve the previous set of results in a paginated API response
beforestringRequired within parentA string token used to retrieve the previous page of results.
linkstringOptionalA URL link to the previous page of results.

Update batch objects — courses batch Update Courses — request body — body

FieldTypePresenceDescription and constraints
$objectRootRepresents a batch input component used to handle multiple simple public objects in a single API request. This component is typically used when performing batch operations to create, update, or delete multiple records simultaneously.
inputsarrayRequired within parentAn array of SimplePublicObjectBatchInput objects. Each object contains the properties and identifiers needed to update a CRM object.
inputs[]ModelEach itemExpand Update batch objects — courses batch Update Courses — request body — body inputs item

Referenced models: Update batch objects — courses batch Update Courses — request body — body inputs item

Update batch objects — courses batch Update Courses — request body — body inputs item

FieldTypePresenceDescription and constraints
$objectRootContains an array of CRM object records to be processed in a batch operation, each defined by their ID and properties.
idstringRequired within parentThe id to be updated. This can be the object id, or the unique property value of the idProperty property
idPropertystringOptionalThe name of a property whose values are unique for this object
objectWriteTraceIdstringOptionalA string used to trace the write operation for debugging or logging purposes.
propertiesobjectRequired within parentAn object containing key-value pairs representing the properties of the CRM object. Each key is a property name, and the value is the property's value.
Additional keys: see wildcard field
properties.*stringAdditional keys

Update — courses update Course — request body — body

FieldTypePresenceDescription and constraints
$objectRootRepresents the input required to update a CRM object, containing an object with property names and their corresponding values.
propertiesobjectRequired within parentA map of property names to their values, where each property is a string. This object contains the properties of the CRM object that need to be updated.
Additional keys: see wildcard field
properties.*stringAdditional keys

Report an issue with this page

Necessary

Required for sign-in, security, authorization, and remembering your choices.

Always active

Analytics

Helps us understand which product and documentation features are useful.

Performance diagnostics

Uses performance tracing and privacy-masked session replay to diagnose problems.

You can change these choices at any time from Cookie settings.