> ## Documentation Index > Fetch the complete documentation index at: https://api-docs.quivo.co/llms.txt > Use this file to discover all available pages before exploring further. # Create article > Create a new article (product/SKU) for the specified seller. ## OpenAPI ````yaml /openapi.json post /articles/{sellerId} openapi: 3.0.1 info: title: Connector version: 80f7edc, 2026-01-23T12:01:00Z description: Enhanced Quivo API documentation with additional descriptions and examples contact: name: Quivo Support email: support@quivo.co url: https://quivo.co license: name: Proprietary url: https://quivo.co/terms termsOfService: https://quivo.co/terms servers: - url: https://api.quivo.co/ description: Production API server for Quivo Connector security: [] tags: - name: addresses description: Manage stored addresses in the seller's address book - name: apiKeyRequests description: Request and manage API keys - name: articles description: Create and manage product articles - name: audits description: Access audit logs and history - name: bundles description: Manage product bundles - name: carriers description: Get carrier information - name: contacts description: Manage contact information - name: countries description: Get country information - name: currencies description: Get currency information - name: customerInquiries description: Manage customer inquiries - name: dashboards description: Access dashboard data - name: files description: Manage file uploads and downloads - name: fulfillmentPlans description: Manage fulfillment plans - name: inbounds description: Manage inbound shipments - name: items description: Monitor and manage inventory items - name: languages description: Get language information - name: notifications description: Manage notifications - name: orders description: Create and manage fulfillment orders - name: ping description: Health check endpoint - name: returnApp description: Manage return applications - name: returnLinks description: Manage return links - name: returns description: Manage returns - name: sellers description: Get seller information - name: shipments description: Book and manage shipments - name: shippingServiceGroups description: Get shipping service groups - name: shopOrders description: Manage shop orders - name: shops description: Manage shops - name: status description: Get system status - name: storedAddresses description: Manage stored addresses - name: subscriptionPackages description: Manage subscription packages - name: subscriptions description: Manage webhook subscriptions - name: track description: Track shipments - name: transports description: Manage transport services - name: users description: Manage users - name: warehouses description: Get warehouse information paths: /articles/{sellerId}: post: tags: - articles summary: Create article description: Create a new article (product/SKU) for the specified seller. operationId: articlesPostArticle parameters: - name: sellerId in: path required: true schema: type: integer format: int64 description: >- The unique identifier for the seller account. This ID is used to scope operations to a specific seller's data and resources. requestBody: content: application/json: schema: $ref: '#/components/schemas/ArticlePost' required: false description: Data to create a new resource at /articles/{sellerId} responses: '200': description: >- Returns the newly created article (product/SKU) with assigned identifier and full product details. content: application/json: schema: $ref: '#/components/schemas/ArticleGetDetail' '400': description: >- Bad request - the request payload is invalid, missing required fields, or contains invalid data. '401': description: >- Unauthorized - authentication credentials are missing, invalid, or expired. '404': description: >- Not found - the requested resource does not exist or is not accessible. '500': description: Internal server error - an unexpected error occurred on the server. components: schemas: ArticlePost: required: - sku type: object properties: sku: maxLength: 50 minLength: 1 type: string description: Stock Keeping Unit (SKU) identifier deletedAt: type: string format: date-time description: The deleted at timestamp alternativeSkus: uniqueItems: true type: array items: type: string description: Stock Keeping Unit (SKU) identifier name: $ref: '#/components/schemas/StringI18nDetail' articleType: type: string enum: - PRODUCT - CARTON description: The type or category of the article barcode: maxLength: 50 minLength: 0 type: string description: Code or identifier supplierReferenceNumber: maxLength: 20 minLength: 0 type: string description: Reference number or identifier for the supplier number alternativeBarcodes: uniqueItems: true type: array items: type: string description: Code or identifier grossWeight: $ref: '#/components/schemas/WeightDetail' netWeight: $ref: '#/components/schemas/WeightDetail' lotRequired: type: boolean description: Indicates whether lot is required expirationDateRequired: type: boolean description: The expiration date required date serialNumberRequired: type: boolean description: Indicates whether serial number is required canShipWithoutCarton: type: boolean description: Boolean flag indicating can ship without carton length: $ref: '#/components/schemas/LengthMeasurementDetail' width: $ref: '#/components/schemas/LengthMeasurementDetail' height: $ref: '#/components/schemas/LengthMeasurementDetail' customsContentDescription: type: string description: Description text countryOfOrigin: type: string enum: - AF - AX - AL - DZ - AS - AD - AO - AI - AQ - AG - AR - AM - AW - AU - AT - AZ - BS - BH - BD - BB - BY - BE - BZ - BJ - BM - BT - BO - BA - BW - BV - BR - IO - BN - BG - BF - BI - KH - CM - CA - CV - KY - CF - TD - CL - CN - CX - CC - CO - KM - CG - CD - CK - CR - CI - HR - CU - CY - CZ - DK - DJ - DM - DO - EC - EG - SV - GQ - ER - EE - ET - FK - FO - FJ - FI - FR - GF - PF - TF - GA - GM - GE - DE - GH - GI - GR - GL - GD - GP - GU - GT - GG - GN - GW - GY - HT - HM - VA - HN - HK - HU - IS - IN - ID - IR - IQ - IE - IM - IL - IT - JM - JP - JE - JO - KZ - KE - KI - KP - KR - XK - KW - KG - LA - LV - LB - LS - LR - LY - LI - LT - LU - MO - MK - MG - MW - MY - MV - ML - MT - MH - MQ - MR - MU - YT - MX - FM - MD - MC - MN - ME - MS - MA - MZ - MM - NA - NR - NP - NL - NC - NZ - NI - NE - NG - NU - NF - MP - 'NO' - OM - PK - PW - PS - PA - PG - PY - PE - PH - PN - PL - PT - PR - QA - RE - RO - RU - RW - BL - SH - KN - LC - MF - PM - VC - WS - SM - ST - SA - SN - RS - SC - SL - SG - SK - SI - SB - SO - ZA - GS - ES - LK - SD - SR - SJ - CW - BQ - SX - SZ - SE - CH - SY - TW - TJ - TZ - TH - TL - TG - TK - TO - TT - TN - TR - TM - TC - TV - UG - UA - AE - GB - US - UM - UY - UZ - VU - VE - VN - VG - VI - WF - EH - YE - ZM - ZW description: Country code or name salesPrice: $ref: '#/components/schemas/MonetaryValueDetail' insuranceValue: $ref: '#/components/schemas/MonetaryValueDetail' customsValue: $ref: '#/components/schemas/MonetaryValueDetail' unNumber: type: string description: Number value customAttributes: type: object additionalProperties: type: string description: Optional value for custom attributes of article. example: '{"attr1":"val1"}' itemGroup: type: string description: The item group lottableBatchRequired: type: boolean description: Indicates whether lottable batch is required alternativeNames: type: array items: $ref: '#/components/schemas/StringI18nDetail' description: The name of the alternative s tariffNumber: maxLength: 20 minLength: 0 type: string description: Number value alternativeSalesPrices: type: array items: $ref: '#/components/schemas/MonetaryValueDetail' description: Price value alternativeInsuranceValues: type: array items: $ref: '#/components/schemas/MonetaryValueDetail' description: The alternative insurance values value alternativeCustomsValues: type: array items: $ref: '#/components/schemas/MonetaryValueDetail' description: The alternative customs values value packagingUnits: type: array items: $ref: '#/components/schemas/PackagingUnitDetail' description: Array of packaging unit lotNumberPriorities: type: object additionalProperties: type: string description: Number value minimumQuantities: type: array items: $ref: '#/components/schemas/ArticleMinimumQuantityDetail' description: Array of minimum quantitie minimumExpirationDates: type: array items: $ref: '#/components/schemas/MinimumExpirationDateDetail' description: The minimum expiration dates date minimumShelfLives: type: array items: $ref: '#/components/schemas/ArticleMinimumShelfLifeDetail' description: Array of minimum shelf live dummyExpirationDate: type: string format: date-time description: The dummy expiration date date dummyLotNumber: type: string description: Number value description: >- Request payload for creating a new article (product/SKU) for a seller. Contains product details including identifiers, descriptions, dimensions, weight, and pricing information. ArticleGetDetail: required: - sku type: object properties: sku: maxLength: 50 minLength: 1 type: string description: Stock Keeping Unit (SKU) identifier deletedAt: type: string format: date-time description: The deleted at timestamp alternativeSkus: uniqueItems: true type: array items: type: string description: Stock Keeping Unit (SKU) identifier name: $ref: '#/components/schemas/StringI18nDetail' articleType: type: string enum: - PRODUCT - CARTON description: The type or category of the article (product). barcode: maxLength: 50 minLength: 0 type: string description: Code or identifier supplierReferenceNumber: maxLength: 20 minLength: 0 type: string description: Reference number provided by the supplier for this article. alternativeBarcodes: uniqueItems: true type: array items: type: string description: Code or identifier grossWeight: $ref: '#/components/schemas/WeightDetail' netWeight: $ref: '#/components/schemas/WeightDetail' lotRequired: type: boolean description: Indicates whether lot is required expirationDateRequired: type: boolean description: Indicates whether an expiration date is required for this article. serialNumberRequired: type: boolean description: Indicates whether serial number is required canShipWithoutCarton: type: boolean description: Boolean flag indicating can ship without carton length: $ref: '#/components/schemas/LengthMeasurementDetail' width: $ref: '#/components/schemas/LengthMeasurementDetail' height: $ref: '#/components/schemas/LengthMeasurementDetail' customsContentDescription: type: string description: Description text countryOfOrigin: type: string enum: - AF - AX - AL - DZ - AS - AD - AO - AI - AQ - AG - AR - AM - AW - AU - AT - AZ - BS - BH - BD - BB - BY - BE - BZ - BJ - BM - BT - BO - BA - BW - BV - BR - IO - BN - BG - BF - BI - KH - CM - CA - CV - KY - CF - TD - CL - CN - CX - CC - CO - KM - CG - CD - CK - CR - CI - HR - CU - CY - CZ - DK - DJ - DM - DO - EC - EG - SV - GQ - ER - EE - ET - FK - FO - FJ - FI - FR - GF - PF - TF - GA - GM - GE - DE - GH - GI - GR - GL - GD - GP - GU - GT - GG - GN - GW - GY - HT - HM - VA - HN - HK - HU - IS - IN - ID - IR - IQ - IE - IM - IL - IT - JM - JP - JE - JO - KZ - KE - KI - KP - KR - XK - KW - KG - LA - LV - LB - LS - LR - LY - LI - LT - LU - MO - MK - MG - MW - MY - MV - ML - MT - MH - MQ - MR - MU - YT - MX - FM - MD - MC - MN - ME - MS - MA - MZ - MM - NA - NR - NP - NL - NC - NZ - NI - NE - NG - NU - NF - MP - 'NO' - OM - PK - PW - PS - PA - PG - PY - PE - PH - PN - PL - PT - PR - QA - RE - RO - RU - RW - BL - SH - KN - LC - MF - PM - VC - WS - SM - ST - SA - SN - RS - SC - SL - SG - SK - SI - SB - SO - ZA - GS - ES - LK - SD - SR - SJ - CW - BQ - SX - SZ - SE - CH - SY - TW - TJ - TZ - TH - TL - TG - TK - TO - TT - TN - TR - TM - TC - TV - UG - UA - AE - GB - US - UM - UY - UZ - VU - VE - VN - VG - VI - WF - EH - YE - ZM - ZW description: Country code or name salesPrice: $ref: '#/components/schemas/MonetaryValueDetail' insuranceValue: $ref: '#/components/schemas/MonetaryValueDetail' customsValue: $ref: '#/components/schemas/MonetaryValueDetail' unNumber: type: string description: Number value customAttributes: type: object additionalProperties: type: string description: Optional value for custom attributes of article. example: '{"attr1":"val1"}' itemGroup: type: string description: The item group lottableBatchRequired: type: boolean description: Indicates whether lottable batch is required alternativeNames: type: array items: $ref: '#/components/schemas/StringI18nDetail' description: The name of the alternative s tariffNumber: maxLength: 20 minLength: 0 type: string description: Number value alternativeSalesPrices: type: array items: $ref: '#/components/schemas/MonetaryValueDetail' description: Price value alternativeInsuranceValues: type: array items: $ref: '#/components/schemas/MonetaryValueDetail' description: Alternative insurance values for customs declaration. alternativeCustomsValues: type: array items: $ref: '#/components/schemas/MonetaryValueDetail' description: Alternative customs values for declaration purposes. packagingUnits: type: array items: $ref: '#/components/schemas/PackagingUnitDetail' description: Array of packaging unit lotNumberPriorities: type: object additionalProperties: type: string description: Number value minimumQuantities: type: array items: $ref: '#/components/schemas/ArticleMinimumQuantityDetail' description: Array of minimum quantitie minimumExpirationDates: type: array items: $ref: '#/components/schemas/MinimumExpirationDateDetail' description: Minimum expiration dates required for this article. minimumShelfLives: type: array items: $ref: '#/components/schemas/ArticleMinimumShelfLifeDetail' description: Array of minimum shelf live dummyExpirationDate: type: string format: date-time description: Placeholder expiration date used when actual date is not available. dummyLotNumber: type: string description: Number value id: type: integer format: int64 description: The unique identifier for the article. created: type: string format: date-time description: Timestamp when the item was created lastModified: type: string format: date-time description: Timestamp when the item was last modified errors: type: array items: $ref: '#/components/schemas/MessageDetail' description: Error information warnings: type: array items: $ref: '#/components/schemas/MessageDetail' description: Array of warning messages or validation issues for this article. sellerId: type: integer format: int64 description: The unique identifier for the seller articleIdentifier: type: string description: The unique identifier for the articleentifier images: type: array items: $ref: '#/components/schemas/ArticleImageGet' description: Image reference lengthM: type: number description: Length measurement widthM: type: number description: Width measurement heightM: type: number description: Height measurement grossWeightKG: type: number description: Weight value netWeightKG: type: number description: Weight value tags: uniqueItems: true type: array items: type: string description: Tags or labels description: >- Detailed article (product/SKU) information returned from API responses. Contains complete product details including identifiers, descriptions, dimensions, weight, pricing, images, and configuration settings. StringI18nDetail: type: object properties: value: maxLength: 255 minLength: 0 type: string description: The value value language: type: string enum: - DE - EN - ES - PT - FR - IT - ZH description: 'The language. Possible values: DE, EN, ES, PT, FR (and 2 more)' description: Detailed information for stringi18n WeightDetail: type: object properties: value: type: number description: The value value unit: type: string enum: - KG - G - LB - OZ description: 'The unit. Possible values: KG, G, LB, OZ' description: Detailed information for weight LengthMeasurementDetail: type: object properties: value: type: number description: The value value unit: type: string enum: - M - DM - CM - MM - IN description: 'The unit. Possible values: M, DM, CM, MM, IN' description: Detailed information for lengthmeasurement MonetaryValueDetail: type: object properties: currencyCode: type: string description: Currency code value: type: number description: The value value description: Detailed information for monetaryvalue PackagingUnitDetail: type: object properties: type: type: string enum: - PALLET - CARTON description: The type or category of the item barcode: type: string description: Code or identifier piecesPerPackagingUnit: type: integer format: int32 description: The pieces per packaging unit numeric value grossWeight: $ref: '#/components/schemas/WeightDetail' netWeight: $ref: '#/components/schemas/WeightDetail' length: $ref: '#/components/schemas/LengthMeasurementDetail' width: $ref: '#/components/schemas/LengthMeasurementDetail' height: $ref: '#/components/schemas/LengthMeasurementDetail' description: Detailed information for packagingunit ArticleMinimumQuantityDetail: required: - warehouseId type: object properties: quantity: type: integer format: int32 description: Quantity or amount warehouseId: type: integer format: int64 description: The unique identifier for the warehouse calculationMode: type: string description: The calculation mode description: Detailed information for articleminimumquantity MinimumExpirationDateDetail: required: - notifyDaysBeforeExpiration - warehouseId type: object properties: notifyDaysBeforeExpiration: minimum: 1 type: integer format: int32 description: The notify days before expiration numeric value warehouseId: type: integer format: int64 description: The unique identifier for the warehouse description: Detailed information for minimumexpirationdate ArticleMinimumShelfLifeDetail: required: - minimumShelfLife - warehouseId type: object properties: minimumShelfLife: minimum: 1 type: integer format: int32 description: The minimum shelf life numeric value warehouseId: type: integer format: int64 description: The unique identifier for the warehouse description: Detailed information for articleminimumshelflife MessageDetail: type: object properties: code: type: string description: Code or identifier description: type: string description: Description text description: Detailed information for message ArticleImageGet: required: - source type: object properties: id: type: string description: The unique identifier for the id url: $ref: '#/components/schemas/Link' packagingUnit: $ref: '#/components/schemas/PackagingUnitDetail' source: type: string description: The source value description: >- Article image information including image metadata, URLs, and display settings. Returned when retrieving or creating article images. Link: type: object properties: link: type: string description: Link or URL reference description: URL link reference. Contains link URL and optional metadata. ````