> ## Documentation Index > Fetch the complete documentation index at: https://integration.delogue.com/llms.txt > Use this file to discover all available pages before exploring further. # Create barcodes > Creates one or more barcodes in a single transaction. The request body is always an array, even for a single item. barcode is required and must be unique within the organization. A value that already exists, or that repeats within the batch, returns 409 naming the offending index. Any failure rolls back the whole batch. Created barcodes are always unlinked: linkedToSku and linkedToStyleAssortment are set by the SKU and style-assortment assign flows and cannot be supplied here. Capped at 200 barcodes per request. ## OpenAPI ````yaml https://service.my.delogue.com/openapi/external.json post /api/barcodes openapi: 3.1.1 info: title: Delogue External API - (Production) description: Integration endpoints for Delogue API version: 1.0.0 servers: - url: / description: The Delogue environment serving this document. - url: https://{host} description: Per-customer Delogue API host. variables: host: default: service.my.delogue.com description: >- The API host for your Delogue environment, e.g. service..delogue.com. security: [] tags: - name: Barcodes - name: Brands - name: CareInstructionIcons - name: CareInstructionLayers - name: CareInstructionMaterials - name: CareInstructions - name: Color Groups - name: Colors - name: ComplianceCategories - name: ComplianceCustomFields - name: Facilities - name: Groups - name: ItemCategories - name: Items - name: MeasurementCharts - name: MigrationApproval - name: MigrationVerification - name: OrganizationMigration - name: Organizations - name: SampleRequests - name: SampleTypes - name: Seasons - name: SizeRanges - name: Style Prices - name: StyleCareInstructions - name: StyleCategories - name: StyleColors - name: StyleContacts - name: StyleCustomFields - name: StyleFiles - name: StyleItems - name: StyleRelations - name: Styles - name: StyleSkus - name: StyleSupplierFacilities - name: SubSuppliers - name: Suppliers paths: /api/barcodes: post: tags: - Barcodes summary: Create barcodes description: >- Creates one or more barcodes in a single transaction. The request body is always an array, even for a single item. barcode is required and must be unique within the organization. A value that already exists, or that repeats within the batch, returns 409 naming the offending index. Any failure rolls back the whole batch. Created barcodes are always unlinked: linkedToSku and linkedToStyleAssortment are set by the SKU and style-assortment assign flows and cannot be supplied here. Capped at 200 barcodes per request. operationId: Barcodes_Create requestBody: content: application/json: schema: type: array items: $ref: '#/components/schemas/BarcodeCreateDto' application/*+json: schema: type: array items: $ref: '#/components/schemas/BarcodeCreateDto' required: true responses: '201': description: Created content: application/json: schema: $ref: '#/components/schemas/ApiResponseOfListOfBarcodeDto' '400': description: Bad Request content: application/json: schema: $ref: '#/components/schemas/ApiBulkErrorResponse' '401': description: Unauthorized content: application/problem+json: schema: $ref: '#/components/schemas/ApiErrorResponse' '403': description: Forbidden content: application/json: schema: $ref: '#/components/schemas/ApiBulkErrorResponse' '409': description: Conflict content: application/json: schema: $ref: '#/components/schemas/ApiBulkErrorResponse' '500': description: Internal Server Error content: application/problem+json: schema: $ref: '#/components/schemas/ApiErrorResponse' security: - {} components: schemas: BarcodeCreateDto: type: object properties: barcode: type: - 'null' - string description: >- The barcode value to create, such as a 13-digit EAN number. Required, and unique within the organization. additionalProperties: false ApiResponseOfListOfBarcodeDto: required: - status - code - data type: object properties: status: $ref: '#/components/schemas/ApiResponseStatus' description: >- The coarse outcome of the request, indicating whether it succeeded or failed. code: type: string description: >- The specific machine-readable outcome code, such as ok on success or the most specific error code on failure. Always lowercase on the wire. data: type: - 'null' - array items: $ref: '#/components/schemas/BarcodeDto' description: >- The response payload, either a single object for a by-id read or an array for a bulk operation. Omitted from the body when there is no value. additionalProperties: false ApiBulkErrorResponse: required: - status - code - error type: object properties: status: $ref: '#/components/schemas/ApiResponseStatus' description: >- The coarse outcome of the request, indicating whether it succeeded or failed. code: type: string description: >- The specific machine-readable outcome code, such as ok on success or the most specific error code on failure. Always lowercase on the wire. error: $ref: '#/components/schemas/BulkErrorDetail' description: >- The bulk error payload, present instead of data when a bulk operation fails. It carries the batch outcome counts and the per-item error rows. additionalProperties: false ApiErrorResponse: type: object properties: status: $ref: '#/components/schemas/ApiResponseStatus' description: >- The coarse outcome of the request, indicating whether it succeeded or failed. code: type: string description: >- The specific machine-readable outcome code, such as ok on success or the most specific error code on failure. Always lowercase on the wire. error: $ref: '#/components/schemas/ErrorWrapper' description: >- The error payload, present instead of data on a failed response. It wraps the list of detail rows describing what went wrong. additionalProperties: false ApiResponseStatus: enum: - success - error type: string description: >- The coarse outcome of the request, indicating whether it succeeded or failed. BarcodeDto: type: object properties: id: type: integer description: Unique identifier of the barcode. format: int64 barcode: type: string description: >- The barcode value assigned to the SKU, such as a 13-digit EAN number. properties: type: array items: type: string description: >- Linkage flags for the barcode. Includes linkedToSku when it is linked to a SKU and linkedToStyleAssortment when it is linked to a style assortment. additionalProperties: false description: >- The response payload, either a single object for a by-id read or an array for a bulk operation. Omitted from the body when there is no value. BulkErrorDetail: required: - operation - total_items - failed_items - summary - details type: object properties: operation: type: string description: >- Identifies which bulk operation this result describes, such as bulk_create, bulk_update, or bulk_delete. total_items: pattern: ^-?(?:0|[1-9]\d*)$ type: - integer - string description: The total number of items submitted in the bulk request. format: int32 failed_items: pattern: ^-?(?:0|[1-9]\d*)$ type: - integer - string description: >- The number of submitted items that failed validation or processing. Because bulk writes are all-or-nothing, any non-zero value means the whole batch was rolled back. format: int32 summary: type: string description: A human-readable summary of why the bulk operation failed. details: type: array items: $ref: '#/components/schemas/ErrorDetailDto' description: >- The individual error rows, one per failing item. Each row's field path is prefixed with the item's array index, such as [3].name. additionalProperties: false description: >- The bulk error payload, present instead of data when a bulk operation fails. It carries the batch outcome counts and the per-item error rows. ErrorWrapper: type: object properties: details: type: array items: $ref: '#/components/schemas/ErrorDetailDto' description: >- The list of individual error detail rows for this failure, one per field or rule that failed. additionalProperties: false description: >- The error payload, present instead of data on a failed response. It wraps the list of detail rows describing what went wrong. ErrorDetailDto: required: - type - field - value type: object properties: type: type: string description: >- The hierarchical error code identifying the specific failure, such as validation_error.required_field. Consumers branch on this rather than on the message text. field: type: - 'null' - string description: >- The input field that caused the failure. Omitted when no specific field is at fault, such as an authorization denial or a server error. value: type: - 'null' - string description: >- A human-readable message describing the failure, or the offending value or limit that triggered it. additionalProperties: false ````