Create listing

POST

/listings

curl --request POST \
  --url https://acme.mykreezalid.com/api/partners/v1/listings \
  --header 'Authorization: Basic <credentials>' \
  --header 'Content-Type: application/json' \
  --data '{ "admin_status": "waiting", "attributes": "[]", "category": { "title": "example" }, "category_id": 432432, "city": "New York City", "country": "US", "currency": "USD", "date_online": "2026-04-15T12:00:00Z", "description": "<p>Lorem ipsum dolor sit amet, consectetur adipiscing elit. Nulla dignissim laoreet sem, quis mollis elit rutrum a. Donec nunc urna, rhoncus in sagittis ut, elementum scelerisque libero. Quisque interdum nibh nisl, non gravida nibh molestie quis. Phasellus nunc nunc, luctus a luctus ac, iaculis sit amet turpis.</p><p>Phasellus tortor orci, posuere in mi at, blandit ullamcorper tellus. Proin vel sem aliquam, faucibus dolor quis, dictum leo. Aliquam consectetur massa at ipsum auctor, at mattis nunc porttitor. Suspendisse potenti. Orci varius natoque penatibus et magnis dis parturient montes, nascetur ridiculus mus.</p>", "external_id": "INTERNAL_REF_234324", "lat": 40.7572114, "lng": -73.9913385, "location": "253 W 42nd St, New York, NY 10036, United States", "min_qty": 1, "medias": "example", "order_type_id": 986545, "price": 123.5, "price_unit": null, "quantity": 43, "quantity_selector": null, "requires_shipping": true, "shipping_methods": [ { "id": 1, "carrier_alias": "fed_ex", "price": 4.95, "sort_priority": 4, "step_price": 0.95, "title": "FedEx" } ], "slug": "listing-s-slug", "state": "NY", "status": "draft", "store_id": 217833, "store_external_id": "SHOP-BRUSSELS-01", "supplier": { "account_type": "individual", "external_id": "ABCdef123456", "address_city": "New-York City", "address_country": "US", "address_line1": "253 W 42nd St", "address_line2": null, "address_state": "NY", "address_zipcode": "NY 10036", "attributes": { "profession": "Web developer" }, "avatar": "example", "business_name": "ACME", "can_post_listing": true, "created": "2026-04-15T12:00:00Z", "email": "admin@acme.com", "first_name": "John", "group_id": 784568, "locale": "en", "note": "4.5", "phone_country_number": "+1", "phone_number": "212-398-2600", "status": "enabled", "review_count": "3", "timezone": "UTC", "username": "BestJohnDoe" }, "supplier_id": 655785, "title": "Listing'\''s title", "variants": { "external_id": "INTERNAL_REF_234324", "listing_id": 324353, "price": 123.5, "price_unit": null, "quantity": "1", "sort_priority": "0", "sku": "BASKT-XYZ-BLN-41", "title": "Blue Shoes Size 41", "weight": 0.8 }, "visibility": "both", "weight": 0.8 }'

• The marketplace's address. A marketplace with a custom domain must be called on that domain instead (https://developers.kreezalid.com/getting-started/base-urls/).

Creates a listing for your vendor account. POST /listings/add is an alias of this endpoint.

title, description, price and category_id are required and must not be empty (a price of 0 is refused). Instead of category_id you can send category as an object holding either the category id or its exact title. Without order_type_id or order_type_url_token, the marketplace’s first available order type is used (see GET /listings/order_types).

New listings are approved and published right away. To create a draft instead, send is_online: 0 and no status.

The response always comes with HTTP status 200: check success, and read message for the reason of a refusal (a missing field, an unknown category, an invalid store reference, a validation error).

Authorizations

• basic

Request Body^required

The listing fields to save. Besides the fields of the Listing object, you can send images: an array of image URLs, which are downloaded and attached to the listing (on update, sending images replaces all the current ones), and order_type_url_token instead of order_type_id. Attributes are sent either as an attributes object keyed by attribute alias, or as flat attributes.<alias> keys. For a multiple-choice attribute, send option IDs or option titles (an array, or one string with titles separated by ##); a title that does not exist yet is added to the attribute’s options. Attributes whose alias does not exist are ignored. HTML in description is converted to plain text.

Media typeapplication/json

object

id

Listing’s unique identifier

integer

Example

645646

object

string

default: Listing

admin_status

Admin validation status of the listing. Possible values: waiting (awaiting approval), approved (visible if status also published), rejected (hidden from the marketplace).

string

Allowed values: waiting approved rejected blocked

Example

approved

attributes

Array

Example

[]

category

object

id

Category’s unique identifier

integer

Example

432432

object

string

default: Category

title

string

url

string

category_id

required

Category’s unique identifier

integer

Example

432432

city

string

nullable

Example

New York City

country

string

nullable

Example

US

cover

string

nullable

currency

string

Example

USD

date_online

string format: date-time

description

string

nullable

Example

<p>Lorem ipsum dolor sit amet, consectetur adipiscing elit. Nulla dignissim laoreet sem, quis mollis elit rutrum a. Donec nunc urna, rhoncus in sagittis ut, elementum scelerisque libero. Quisque interdum nibh nisl, non gravida nibh molestie quis. Phasellus nunc nunc, luctus a luctus ac, iaculis sit amet turpis.</p><p>Phasellus tortor orci, posuere in mi at, blandit ullamcorper tellus. Proin vel sem aliquam, faucibus dolor quis, dictum leo. Aliquam consectetur massa at ipsum auctor, at mattis nunc porttitor. Suspendisse potenti. Orci varius natoque penatibus et magnis dis parturient montes, nascetur ridiculus mus.</p>

external_id

string

nullable

Example

INTERNAL_REF_234324

lat

number

nullable

Example

40.7572114

lng

number

nullable

Example

-73.9913385

location

string

nullable

Example

253 W 42nd St, New York, NY 10036, United States

min_qty

number

nullable

Example

1

medias

string

order_type_id

required

Order type’s unique identifier

integer

Example

986545

price

number format: double

nullable

Example

123.5

price_unit

integer

nullable

Example

null

price_with_currency

string

Example

$123.50

quantity

integer

nullable

Example

43

quantity_selector

string

nullable

Example

null

requires_shipping

boolean

Example

true

shipping_methods

Array<object>

object

id

integer

Example

1

carrier_alias

string

Example

fed_ex

price

number

Example

4.95

sort_priority

number

Example

4

step_price

number

Example

0.95

title

string

Example

FedEx

slug

string

nullable

Example

listing-s-slug

state

string

nullable

Example

NY

status

Public status of the listing. Possible values: draft, published (visible), archived (hidden).

string

Allowed values: draft published archived

Example

published

store_id

The store that holds this listing, by its id (as returned by GET /stores). The listing then shows at that store’s address, and buyers are told where to collect it. Leave the field out entirely to keep whatever store it already had. To move the listing, send the store it moves TO: a listing already in a store CANNOT be taken out of one by sending an empty value, because attaching replaced its own address and there is none to fall back to — unpublish it instead. A store that is not one of yours is refused. Send either store_id or store_external_id, not both.

integer

nullable

Example

217833

store_external_id

Optional alternative to store_id: YOUR OWN code for the store, the external_id you gave it. Only usable for a store that has one. Same rules as store_id: leave it out to keep the current store, send the code of the store the listing moves to, an empty value cannot take a listing out of its store. Send either store_id or store_external_id, not both.

string

nullable

Example

SHOP-BRUSSELS-01

supplier

User resource

object

id

User’s unique identifier

integer

Example

545353

object

string

default: User

account_type

string

Allowed values: individual company non-profit

Example

individual

external_id

string

nullable

Example

ABCdef123456

address_city

string

Example

New-York City

address_country

string

Example

US

address_line1

string

nullable

Example

253 W 42nd St

address_line2

string

nullable

Example

null

address_state

string

nullable

Example

NY

address_zipcode

string

nullable

Example

NY 10036

attributes

Array

nullable

Example

{
  "profession": "Web developer"
}

avatar

Absolute URL of the profile image

string

nullable

business_name

Company or organization name

string

nullable

Example

ACME

can_post_listing

boolean

created

string format: date-time

email

required

string

Example

admin@acme.com

first_name

string

nullable

Example

John

group

Array<object>

object

object

string

default: Group

id

Group’s unique identifier

integer

Example

784568

name

string

Example

VIP Customers

alias

string

Example

vip-customers

group_alias

string

group_id

required

integer

Example

784568

group_name

string

lang

string

last_name

string

Example

Doe

locale

string

nullable

Example

en

note

Average note based on reviews

integer

Example

4.5

phone_country_number

string

nullable

Example

+1

phone_number

string

nullable

Example

212-398-2600

profile_url

string

public_name

string

Example

John Doe

status

Account status. Possible values are “enabled2” or “disabled”

string

Allowed values: enabled disabled

store_id

integer

nullable

Example

123456

review_count

integer

Example

3

timezone

string

default: UTC

Example

America/New_York

username

string

nullable

Example

BestJohnDoe

supplier_id

required

Supplier’s unique identifier

integer

Example

655785

title

required

string

Example

Listing's title

url

string

variants

object

id

Variant’s unique identifier

integer

Example

432432

object

string

default: Variant

external_id

string

nullable

Example

INTERNAL_REF_234324

listing_id

integer

Example

324353

price

number format: double

nullable

Example

123.5

price_unit

number format: double

nullable

Example

null

quantity

The quantity of the variant that is available for sale

number

default: 1 nullable

Example

10

sort_priority

Sorts the variants with the lowest number first. Negative numbers are allowed.

number

default: 0 nullable

Example

10

sku

string

nullable

Example

BASKT-XYZ-BLN-41

title

required

string

Example

Blue Shoes Size 41

weight

number

Example

0.8

visibility

Defines where the listing is displayed. Possible values: both (visible in catalog and search), catalog (only catalog), search (only search results), none (not visible).

string

Allowed values: both catalog search none

Example

both

weight

number

Example

0.8

Responses

200

The outcome of the creation.

Media typeapplication/json

Outcome of a listing creation.

object

totalResultsCount

Number of results across all pages.

integer

currentPage

Number of the page returned, starting at 1.

integer

nextPage

Whether a next page exists.

boolean

prevPage

Whether a previous page exists.

boolean

resultOnPageCount

Number of results on this page.

integer

pageCount

Number of pages.

integer

id

ID of the new listing, or null when it was not created.

integer

nullable

success

Whether the listing was created.

boolean

message

Listing created, or the reason of the refusal.

string

nullable

Example

{
  "totalResultsCount": 137,
  "currentPage": 1,
  "resultOnPageCount": 25,
  "pageCount": 6,
  "id": 4242,
  "message": "Listing created"
}

403

Missing or wrong API credentials.