---
title: "Create a single article"
method: POST
path: "/articles"
tags: ["Articles"]
---

# Create a single article

`POST /articles`

This resource could be used to create an article for your point of sale. 

In order to get the available products that we offer, see the 'Product Types' section. There you can also find the
necessary ids required to build the payload.

In the variants array, you can enable the sizes and colours of your product.

In the configuration array, you can place designs via url. The image must be in PNG format and under 10 MB.
At this moment, the designs will be scaled as big as possible, keeping in mind the resolution of the chosen design 
and the limits of the print area.

Additionally, you can use a designId returned when uploading a design via Designs endpoint.

An image object must contain at least a url or a designId. If both are present, designId will be used.

The external id fields can be used for identifying articles and variants. They are optional, but if they are present
they are validated as being not duplicates, in the article context

## Request body

- ArticleCreation
  - `title` string, required
  - `description` string, required
  - `variants` object[], required — product variants
    - `productTypeId` integer, required — sprd product type id
    - `appearanceId` integer, required — sprd appearance id
    - `sizeId` integer, required — sprd size id
    - `d2cPrice` number — final price for the customer
    - `externalId` string — optional id that can be used for identifying the article variant - validated for UUID v4
  - `configurations` object[], required — product
    - `image` object, required
      - `url` string
      - `designId` string
    - `view` 'FRONT' | 'BACK' | 'LEFT' | 'RIGHT' | 'HOOD_LEFT' | 'HOOD_RIGHT', required
    - `hotspot` 'FULL_FRONT' | 'MEDIUM_FRONT' | 'LEFT_CHEST' | 'RIGHT_CHEST' | 'FULL_BACK' | 'MEDIUM_BACK' | 'BACK_COLLAR' | 'RIGHT' | 'LEFT' | 'CENTER_CHEST'
    - `position` object — Custom print position. Before using a custom print position, check the product type's printAreas to ensure the position is valid for the selected view.
      - `offsetX` number, double, required
      - `offsetY` number, double, required
      - `width` number, double, required
      - `height` number, double, required
  - `externalId` string — optional id that can be used for identifying the article - validated for UUID v4

## Response `202`

OK

- number — The unique identifier of the created article

---

[API](https://skmtc.net/spreadconnect/apis/spreadconnect-fulfillment-service-rest-api.md) · [All operations](https://skmtc.net/spreadconnect/apis/spreadconnect-fulfillment-service-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/spreadconnect/spreadconnect-fulfillment-service-rest-api/revisions/c5159bc39a84/schema)