API Reference

Create Articles Bulk

post
https://merchants-api.cdon.com/api/v2/articles/bulk

The POST request to this endpoint allows you to bulk upload articles.

Request Body

  • articles (array): An array of articles, see schemas for more information on the article structure.

Response

The response will include a success array containing the IDs and SKUs of successfully added articles, and a failed array for any articles that failed to be added. Each failed article will have its SKU and an array of errors with messages and fields that caused the failure.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…

The POST request to this endpoint allows you to bulk upload articles.

Request Body

  • articles (array): An array of articles, see schemas for more information on the article structure.

Response

The response will include a success array containing the IDs and SKUs of successfully added articles, and a failed array for any articles that failed to be added. Each failed article will have its SKU and an array of errors with messages and fields that caused the failure.


Body Params
articles
array of objects
required
length between 1 and 100
articles*
string
required
length between 1 and 64

Your unique ID for the article

string
enum
required

Sale status for the article

Allowed:
integer
required
0 to 500000

Quantity in stock

uri
required
length between 1 and 1500

Direct link to main image

markets
array of objects
required
length between 1 and 10

Countries for sale

markets*
Allowed:
price
array of objects
required
length between 1 and 10

Market-specific pricing with VAT included

price*
shipping_time
array of objects
required
length between 1 and 10

Delivery time range per market

shipping_time*
title
array of objects
required
length between 1 and 10

Article name in multiple languages

title*
description
array of objects
required
length between 1 and 10

Detailed description in multiple languages

description*
string
length between 1 and 64

Group-identifier for product variations

string
length between 1 and 10

Category of the article

string
length between 1 and 50

Manufacturer

string
length between 8 and 14

Global identifier

images
array of uris
length ≤ 10

Additional image links

images
properties
array of objects
length ≤ 50

Article properties

properties
variational_properties
array of strings
length ≤ 2

Properties for variations

variational_properties
unique_selling_points
array of objects
length ≤ 10

Key selling points

unique_selling_points
specifications
array of objects
length ≤ 10

Technical specs

specifications
classifications
array of objects
length ≤ 10

Classification attributes

classifications
delivery_type
array of objects
length ≤ 10

Delivery method per market

delivery_type
string
length between 1 and 48

Combined nomenclature code

string
enum

Origin of shipment

Allowed:
availability_dates
array of objects
length ≤ 10

Availability dates per market

availability_dates
string
length between 1 and 60

Internal note for the article

string
length between 1 and 250

Manufacturer part number

manufacturer
object

Manufacturer / GPSR details

shipping_configuration_ids
array of uuids

Shipping configuration IDs that override your default shipping configurations for this article. CDON only — see the Shipping Configurations section.

shipping_configuration_ids
Responses

Updated 10 days ago

Did this page help you?
Language
Credentials
Basic
base64
:
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated 10 days ago

Did this page help you?