API Documentation

Products CREATE

Purpose/Overview

This request is for creating a single product for a seller.

URL

POST /seller_api/products?v=1.1

cURL Example

curl https://dawanda.com/seller_api/products?v=1.1 \
  -X POST \
  -d "@my_product.xml" \
  -H "Content-Type: text/xml" \
  -H "X-Dawanda-Auth: YOUR_API_KEY"

Success Response(s)

A successful request will respond with an XML response with a relative URL to the products page:

<product url="URL" status="success" />

Example:

<product url="/product/123-my-product" status="success" />

Failure Responses

When an error has occurred, the API will respond with an appropriate HTTP Status code. The response body will contain an XML document containing a human readable error message and additional details (if any).

See also: Error Codes.

Relevant Information

When creating or updating products, images are asynchronously downloaded from the URLs provided. However, the API issues a synchronous HTTP HEAD request to determine if the image URLs are valid. If the HTTP HEAD request returns a non-200 status code, the create/update will fail with a 422 Record Invalid error response.

Allowed values for the mailable_in attribute:

Constraints

This request requires authentication.

Schema

Example XML

Link to XML: Product.xml

Related Requests/Pages