> ## Documentation Index > Fetch the complete documentation index at: https://developers.hubspot.de/docs/llms.txt > Use this file to discover all available pages before exploring further. # Create a batch of products > Dieser Endpunkt erstellt einen Batch von CRM-Objekten mit den spezifizierten Eigenschaften. Ermöglicht das Erstellen mehrerer Objekte in einer einzigen Anfrage, was für den effizienten Import großer Datensätze oder die Synchronisierung von Daten aus externen Systemen nützlich sein kann. Die Antwort enthält die erstellten Objekte mit ihren IDs. > **Supported products** > **Required Scopes** ## OpenAPI ````yaml specs/2026-09/crm-products-v2026-09.json POST /crm/objects/2026-09/products/batch/create openapi: 3.0.1 info: title: CRM Products description: Basepom for all HubSpot Projects version: 2026-09 x-hubspot-product-tier-requirements: marketing: FREE sales: FREE service: FREE cms: FREE commerce: FREE crmHub: FREE dataHub: FREE servers: - url: https://api.hubapi.com security: [] tags: - name: Advanced - name: Basic - name: Batch - name: Search paths: /crm/objects/2026-09/products/batch/create: post: tags: - Batch summary: Objekte batchweise erstellen description: >- Dieser Endpunkt erstellt einen Batch von CRM-Objekten mit den spezifizierten Eigenschaften. Ermöglicht das Erstellen mehrerer Objekte in einer einzigen Anfrage, was für den effizienten Import großer Datensätze oder die Synchronisierung von Daten aus externen Systemen nützlich sein kann. Die Antwort enthält die erstellten Objekte mit ihren IDs. operationId: >- post-/crm/objects/2026-09/products/batch/create_/crm/objects/2026-09-beta/{objectType}/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.deals.read - oauth2: - crm.objects.subscriptions.read - oauth2: - crm.objects.services.read - oauth2: - crm.objects.tickets.sensitive.read - oauth2: - crm.objects.orders.read - oauth2: - crm.objects.listings.write - oauth2: - crm.objects.custom.read - oauth2: - crm.objects.companies.write - oauth2: - crm.objects.tasks.read - oauth2: - crm.objects.custom.sensitive.write.v2 - oauth2: - crm.objects.custom.highly_sensitive.write.v2 - oauth2: - crm.objects.companies.read - oauth2: - crm.objects.appointments.sensitive.read.v2 - oauth2: - crm.objects.contacts.highly_sensitive.read.v2 - oauth2: - crm.objects.tickets.highly_sensitive.read - oauth2: - crm.objects.companies.sensitive.read.v2 - oauth2: - crm.objects.tickets.sensitive.write - oauth2: - media_bridge.read - oauth2: - crm.objects.deals.highly_sensitive.read.v2 - oauth2: - crm.objects.contacts.highly_sensitive.write.v2 - oauth2: - crm.objects.companies.highly_sensitive.read.v2 - oauth2: - crm.objects.commercepayments.write - oauth2: - crm.objects.invoices.write - oauth2: - crm.objects.contacts.sensitive.write.v2 - oauth2: - crm.objects.calls.read - oauth2: - crm.objects.users.write - oauth2: - crm.objects.meetings.read - oauth2: - crm.objects.custom.sensitive.read.v2 - oauth2: - crm.objects.users.read - oauth2: - crm.objects.partner-services.read - oauth2: - crm.objects.orders.write - oauth2: - crm.objects.partner-services.write - oauth2: - crm.objects.appointments.write - oauth2: - crm.objects.projects.highly_sensitive.write - oauth2: - crm.objects.carts.write - oauth2: - crm.objects.tickets.highly_sensitive.write - oauth2: - crm.objects.commercepayments.read - oauth2: - crm.objects.products.write - oauth2: - crm.objects.feedback_submissions.read - oauth2: - crm.objects.services.write - oauth2: - crm.objects.subscriptions.write - oauth2: - crm.objects.deals.sensitive.write.v2 - oauth2: - crm.objects.contacts.read - oauth2: - crm.objects.appointments.sensitive.write.v2 - oauth2: - crm.objects.projects.highly_sensitive.read - oauth2: - crm.objects.invoices.read - oauth2: - crm.objects.custom.write - oauth2: - tickets.sensitive.v2 - oauth2: - crm.objects.deals.write - oauth2: - e-commerce - oauth2: - crm.objects.appointments.read - oauth2: - crm.objects.projects.read - oauth2: - crm.objects.companies.sensitive.write.v2 - oauth2: - crm.objects.companies.highly_sensitive.write.v2 - oauth2: - crm.objects.deals.highly_sensitive.write.v2 - oauth2: - crm.objects.custom.highly_sensitive.read.v2 - oauth2: - crm.objects.goals.write - oauth2: - crm.objects.projects.sensitive.read - oauth2: - crm.objects.line_items.write - oauth2: - crm.objects.contacts.write - oauth2: - crm.objects.goals.read - oauth2: - crm.objects.line_items.read - oauth2: - crm.objects.partner-clients.write - oauth2: - crm.objects.projects.write - oauth2: - crm.objects.projects.sensitive.write - oauth2: - crm.objects.deals.sensitive.read.v2 - oauth2: - crm.objects.quotes.write - oauth2: - tickets.highly_sensitive.v2 - oauth2: - crm.objects.leads.read - oauth2: - crm.objects.leads.write - oauth2: - crm.objects.carts.read - oauth2: - crm.objects.emails.read - oauth2: - crm.objects.quotes.read - oauth2: - crm.objects.courses.write - oauth2: - crm.objects.partner-clients.read - oauth2: - crm.objects.notes.read - oauth2: - crm.objects.courses.read - oauth2: - crm.objects.listings.read - oauth2: - crm.objects.contacts.sensitive.read.v2 - oauth2: - crm.objects.products.read components: schemas: BatchInputSimplePublicObjectBatchInputForCreate: required: - inputs type: object properties: inputs: type: array description: >- Ein Array von SimplePublicObjectBatchInputForCreate-Objekten, die jeweils die Eigenschaften und Zuordnungen enthalten, die zum Erstellen eines einzelnen CRM-Objekts erforderlich sind. items: $ref: '#/components/schemas/SimplePublicObjectBatchInputForCreate' description: >- Stellt eine Batch-Eingabe zum Erstellen mehrerer einfacher öffentlicher Objekte in einer einzigen Anfrage dar. Diese Komponente wird verwendet, um den Prozess des Hinzufügens neuer Objekte zu einem HubSpot-Account zu optimieren, indem mehrere Einträge gleichzeitig erstellt werden können. BatchResponseSimplePublicObject: required: - completedAt - results - startedAt - status type: object properties: completedAt: type: string description: >- Der Zeitpunkt (Datum und Uhrzeit), zu dem der Batch-Vorgang im ISO-8601-Format abgeschlossen wurde. format: date-time links: type: object additionalProperties: type: string description: >- Eine Zuordnung von Linknamen zu zugehörigen URIs, die zusätzliche Ressourcen oder Dokumentationen im Zusammenhang mit dem Batch-Vorgang bereitstellt. requestedAt: type: string description: >- Der Zeitpunkt (Datum und Uhrzeit), zu dem der Batch-Vorgang im ISO-8601-Format angefordert wurde. format: date-time results: type: array description: >- Ein Array von SimplePublicObject-Elementen, das die Ergebnisse des Batch-Vorgangs darstellt. items: $ref: '#/components/schemas/SimplePublicObject' startedAt: type: string description: >- Der Zeitpunkt (Datum und Uhrzeit), zu dem der Batch-Vorgang im ISO-8601-Format gestartet wurde. format: date-time status: type: string description: >- Der aktuelle Status des Batch-Vorgangs. Gültige Werte sind „PENDING“, „PROCESSING“, „CANCELED“ und „COMPLETE“. enum: - CANCELED - COMPLETE - PENDING - PROCESSING description: Ein öffentliches Objekt-Batch-Antwortobjekt BatchResponseSimplePublicObjectWithErrors: required: - completedAt - results - startedAt - status type: object properties: completedAt: type: string description: >- Der Zeitpunkt (Datum und Uhrzeit), zu dem der Batch-Vorgang im ISO-8601-Format abgeschlossen wurde. format: date-time errors: type: array description: >- Ein Array von Fehlern, die während des Batch-Vorgangs aufgetreten sind, wobei jedes Element durch ein StandardError-Objekt dargestellt wird. items: $ref: '#/components/schemas/StandardError' links: type: object additionalProperties: type: string description: >- Eine Zuordnung von Linknamen zu zugehörigen URIs, die zusätzliche Informationen oder Aktionen im Zusammenhang mit dem Batch-Vorgang bereitstellt. numErrors: type: integer description: Die Anzahl der während des Batch-Vorgangs aufgetretenen Fehler. format: int32 requestedAt: type: string description: >- Der Zeitpunkt (Datum und Uhrzeit), zu dem der Batch-Vorgang im ISO-8601-Format angefordert wurde. format: date-time results: type: array description: >- Ein Array von einfachen öffentlichen Objekten, die im Batch-Vorgang verarbeitet wurden. items: $ref: '#/components/schemas/SimplePublicObject' startedAt: type: string description: >- Der Zeitpunkt (Datum und Uhrzeit), zu dem der Batch-Vorgang im ISO-8601-Format gestartet wurde. format: date-time status: type: string description: >- Der aktuelle Status des Batch-Vorgangs. Gültige Werte sind „PENDING“, „PROCESSING“, „CANCELED“ und „COMPLETE“. enum: - CANCELED - COMPLETE - PENDING - PROCESSING description: >- Stellt das Ergebnis eines Batch-Vorgangs für CRM-Objekte dar, einschließlich des Verarbeitungsstatus, der Batch-Ergebnisse, der Zeitstempel und einer Liste aller während des Vorgangs aufgetretenen Fehler. SimplePublicObjectBatchInputForCreate: required: - associations - properties type: object properties: associations: type: array description: >- Ein Array von Zuordnungen, die Beziehungen zwischen den zu erstellenden CRM-Objekten und anderen Objekten definieren. Jede Zuordnung wird mithilfe des PublicAssociationsForObject-Schemas angegeben. items: $ref: '#/components/schemas/PublicAssociationsForObject' objectWriteTraceId: type: string description: >- Eine Zeichenfolge, die zum Tracen des Schreibvorgangs für die Fehlerbehebung und Protokollierung verwendet wird. properties: type: object additionalProperties: type: string description: >- Ein Objekt, das Schlüssel-Wert-Paare enthält, wobei die Schlüssel Eigenschaftsnamen und die Werte die entsprechenden Eigenschaftswerte für die zu erstellenden CRM-Objekte sind. description: >- Ein Eingabeobjekt, das eine Sammlung von Objekten enthält, die zusammen in einem Batch erstellt werden sollen. SimplePublicObject: required: - archived - createdAt - id - properties - updatedAt type: object properties: archived: type: boolean description: Ein boolescher Wert, der angibt, ob dieses Objekt archiviert ist. archivedAt: type: string description: >- Der Zeitpunkt (Datum und Uhrzeit) der Archivierung dieses Objekts im ISO-8601-Format. format: date-time createdAt: type: string description: >- Der Zeitpunkt (Datum und Uhrzeit) der Erstellung dieses Objekts im ISO-8601-Format. format: date-time id: type: string description: Die eindeutige ID für dieses Objekt, dargestellt als Zeichenfolge. objectWriteTraceId: type: string description: >- Eine Zeichenfolge, die zum Tracen der Schreibvorgänge für dieses Objekt verwendet wird. properties: type: object additionalProperties: type: string description: >- Eine Zuordnung von Eigenschaftsnamen zu ihren Werten, wobei jeder Wert eine Zeichenfolge ist. propertiesWithHistory: type: object additionalProperties: type: array items: $ref: '#/components/schemas/ValueWithTimestamp' description: >- Eine Zuordnung von Eigenschaftsnamen zu einem Array von historischen Werten, jeweils mit einem Zeitstempel und Quellinformationen. updatedAt: type: string description: >- Der Zeitpunkt (Datum und Uhrzeit) der letzten Aktualisierung dieses Objekts im ISO-8601-Format. format: date-time url: type: string description: Eine Zeichenfolge, die die URL dieses Objekts darstellt. warnings: type: array description: >- Ein Array von Warnungen zu diesem Objekt, die jeweils eine Kategorie, eine Nachricht und einen Kontext enthalten. items: $ref: '#/components/schemas/PublicObjectWarning' description: Ein einfaches öffentliches Objekt. StandardError: required: - category - context - errors - links - message - status type: object properties: category: type: string description: Eine Zeichenfolge, die den Fehler kategorisiert. context: type: object additionalProperties: type: array items: type: string description: >- Ein Objekt, das zusätzlichen Kontext zum Fehler enthält, wobei die Schlüssel als Kontextnamen und Werte als Arrays von Zeichenfolgen dargestellt werden. errors: type: array description: >- Ein Array von ErrorDetail-Objekten mit weiteren Informationen zum aufgetretenen Fehler. items: $ref: '#/components/schemas/ErrorDetail' id: type: string description: Eine Zeichenfolge, die die eindeutige ID für den Fehler darstellt. links: type: object additionalProperties: type: string description: >- Ein Objekt, das Namen von Links zu zugeordneten URIs zuordnet, mit einer Dokumentation zum Fehler oder empfohlenen Abhilfemaßnahmen. message: type: string description: >- Eine Zeichenfolge, die eine für Menschen lesbare Nachricht mit einer Beschreibung des Fehlers enthält. status: type: string description: Eine Zeichenfolge, die auf den Status des Fehlers verweist. subCategory: type: object properties: {} description: >- Ein Objekt, das eine spezifischere Kategorisierung des Fehlers bereitstellt. description: >- Stellt eine Standard-Fehlerantwort in der HubSpot-API dar, die detaillierte Informationen über einen Fehler bereitstellt, der während einer API-Anfrage aufgetreten ist. Error: required: - category - correlationId - message type: object properties: category: type: string description: Die Fehlerkategorie context: type: object additionalProperties: type: array items: type: string description: Kontext zur Fehlerbedingung example: >- {invalidPropertyName=[propertyValue], missingScopes=[scope1, scope2]} correlationId: type: string description: >- Eine eindeutige ID für die Anfrage. Berücksichtigen Sie diesen Wert in Fehlerberichten oder Support-Tickets. format: uuid example: aeb5f871-7f07-4993-9211-075dc63e7cbf errors: type: array description: Weitere Informationen zum Fehler items: $ref: '#/components/schemas/ErrorDetail' links: type: object additionalProperties: type: string description: >- Eine Zuordnung der Namen von Links zu zugeordneten URIs mit einer Dokumentation zum Fehler oder empfohlenen Abhilfemaßnahmen message: type: string description: >- Eine für Menschen lesbare Nachricht mit einer Beschreibung des Fehlers und ggf. Abhilfemaßnahmen example: An error occurred subCategory: type: string description: Eine spezifische Kategorie, die genauere Details zum Fehler enthält description: >- Stellt eine Fehlerantwort dar, die von der API zurückgegeben wird, wenn ein Vorgang fehlschlägt. Diese Komponente wird in verschiedenen Endpunkten verwendet, um detaillierte Informationen über den aufgetretenen Fehler bereitzustellen. 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: >- Ein Array von Zuordnungsspezifikationen, die jeweils den Beziehungstyp zwischen den Objekten definieren. items: $ref: '#/components/schemas/AssociationSpec' description: >- Stellt die Zuordnungen für ein bestimmtes Objekt in HubSpot dar und beschreibt die Typen von Zuordnungen und die beteiligten zugeordneten Objekte. ValueWithTimestamp: required: - sourceType - timestamp - value type: object properties: sourceId: type: string description: >- Eine Zeichenfolgen-ID für die spezifische Quelle, die den Wert bereitgestellt hat. sourceLabel: type: string description: Ein Zeichenfolgenlabel, das die Quelle des Werts beschreibt. sourceType: type: string description: >- Eine Zeichenfolge, die den Typ der Quelle angibt, die den Wert bereitgestellt hat. timestamp: type: string description: >- Der Zeitpunkt (Datum und Uhrzeit) der Erfassung des Werts im ISO-8601-Format. format: date-time updatedByUserId: type: integer description: >- Eine Ganzzahl, die die ID des Benutzers darstellt, der den Wert zuletzt aktualisiert hat. format: int32 value: type: string description: Der aktuelle Wert der Eigenschaft, dargestellt als Zeichenfolge. description: Eigenschaftsmodell, das einen Zeitstempel enthält. PublicObjectWarning: required: - category - context - message type: object properties: category: type: string description: Eine Zeichenfolge, die die Kategorie der Warnung angibt. context: type: object additionalProperties: type: string description: >- Ein Objekt, das zusätzlichen Kontext zur Warnung bereitstellt, mit Zeichenfolgenwerten für jeden Kontextschlüssel. message: type: string description: Eine Zeichenfolge, die die Warnmeldung enthält. description: >- Stellt eine Warnmeldung zu einem öffentlichen Objekt in HubSpot dar, die Details zur Art und zum Kontext der Warnung bereitstellt. ErrorDetail: required: - message type: object properties: code: type: string description: Der Statuscode, der dem Fehlerdetail zugeordnet ist context: type: object additionalProperties: type: array items: type: string description: Kontext zur Fehlerbedingung example: '{missingScopes=[scope1, scope2]}' in: type: string description: >- Der Name des Felds oder Parameters, in dem der Fehler gefunden wurde. message: type: string description: >- Eine für Menschen lesbare Nachricht mit einer Beschreibung des Fehlers und ggf. Abhilfemaßnahmen subCategory: type: string description: Eine spezifische Kategorie, die genauere Details zum Fehler enthält description: >- Stellt detaillierte Informationen zu einem in der API aufgetretenen Fehler dar. Diese Komponente wird verwendet, um zusätzlichen Kontext und spezifische Details zu Fehlern bereitzustellen, typischerweise als Teil einer Fehlerantwort. PublicObjectId: required: - id type: object properties: id: type: string description: >- Die eindeutige ID für das CRM-Objekt. Es ist ein Zeichenfolgenwert, der als Referenz für das spezifische Objekt innerhalb des Systems dient. description: Contains the Id of a Public Object AssociationSpec: required: - associationCategory - associationTypeId type: object properties: associationCategory: type: string description: >- Die Kategorie der Zuordnung, die deren Ursprung oder Zweck angibt. Gültige Werte sind „HUBSPOT_DEFINED“, „USER_DEFINED“, „INTEGRATOR_DEFINED“ und „WORK“. enum: - HUBSPOT_DEFINED - INTEGRATOR_DEFINED - USER_DEFINED - WORK associationTypeId: type: integer description: >- Eine Ganzzahl, die den spezifischen Zuordnungstyp zwischen Objekten darstellt. format: int32 description: >- Definiert den Typ, die Richtung und die Details der Beziehung zwischen zwei CRM-Objekten. 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.appointments.read: '' crm.objects.appointments.sensitive.read.v2: '' crm.objects.appointments.sensitive.write.v2: '' crm.objects.appointments.write: '' crm.objects.calls.read: '' crm.objects.carts.read: '' crm.objects.carts.write: '' crm.objects.commercepayments.read: '' crm.objects.commercepayments.write: '' crm.objects.companies.highly_sensitive.read.v2: '' crm.objects.companies.highly_sensitive.write.v2: '' crm.objects.companies.read: '' crm.objects.companies.sensitive.read.v2: '' crm.objects.companies.sensitive.write.v2: '' crm.objects.companies.write: '' crm.objects.contacts.highly_sensitive.read.v2: '' crm.objects.contacts.highly_sensitive.write.v2: '' crm.objects.contacts.read: '' crm.objects.contacts.sensitive.read.v2: '' crm.objects.contacts.sensitive.write.v2: '' crm.objects.contacts.write: '' crm.objects.courses.read: '' crm.objects.courses.write: '' crm.objects.custom.highly_sensitive.read.v2: '' crm.objects.custom.highly_sensitive.write.v2: '' crm.objects.custom.read: '' crm.objects.custom.sensitive.read.v2: '' crm.objects.custom.sensitive.write.v2: '' crm.objects.custom.write: '' crm.objects.deals.highly_sensitive.read.v2: '' crm.objects.deals.highly_sensitive.write.v2: '' crm.objects.deals.read: '' crm.objects.deals.sensitive.read.v2: '' crm.objects.deals.sensitive.write.v2: '' crm.objects.deals.write: '' crm.objects.emails.read: '' crm.objects.feedback_submissions.read: '' crm.objects.goals.read: '' crm.objects.goals.write: '' crm.objects.invoices.read: '' crm.objects.invoices.write: '' crm.objects.leads.read: '' crm.objects.leads.write: '' crm.objects.line_items.read: '' crm.objects.line_items.write: '' crm.objects.listings.read: '' crm.objects.listings.write: '' crm.objects.meetings.read: '' crm.objects.notes.read: '' crm.objects.orders.read: '' crm.objects.orders.write: '' crm.objects.partner-clients.read: '' crm.objects.partner-clients.write: '' crm.objects.partner-services.read: '' crm.objects.partner-services.write: '' crm.objects.products.read: '' crm.objects.products.write: '' crm.objects.projects.highly_sensitive.read: '' crm.objects.projects.highly_sensitive.write: '' crm.objects.projects.read: '' crm.objects.projects.sensitive.read: '' crm.objects.projects.sensitive.write: '' crm.objects.projects.write: '' crm.objects.quotes.read: '' crm.objects.quotes.write: '' crm.objects.services.read: '' crm.objects.services.write: '' crm.objects.subscriptions.read: '' crm.objects.subscriptions.write: '' crm.objects.tasks.read: '' crm.objects.tickets.highly_sensitive.read: '' crm.objects.tickets.highly_sensitive.write: '' crm.objects.tickets.sensitive.read: '' crm.objects.tickets.sensitive.write: '' crm.objects.users.read: '' crm.objects.users.write: '' e-commerce: '' media_bridge.read: '' tickets.highly_sensitive.v2: '' tickets.sensitive.v2: '' ````