API: Bulk Product Upload

Upload multiple products to your Dezyn3D inventory in a single API call. This is the most efficient way to sync your entire catalog.

Endpoint

POST/v1/bulk_upload

Headers

X-Dezyn-Access-Token: YOUR_ACCESS_TOKEN — Your unique access token. You can generate one from your API Integration page.
Content-Type: application/json

Request Body

The body should be a JSON array of product objects. For each object, title, product_id, and front_image_url are required. Other image URLs are optional but recommended.

Responses

The API will return a JSON object indicating the status of the request.

Success

HTTP 200 OK
{
  "message": "Success message appears here"
}

Failure

HTTP 400/500 Bad Request/Server Error
{
  "error": "A description of what went wrong."
}

Example (Python)


import requests
import json

API_BASE_URL = "https://api.dezyn.app"
# Replace with your actual access token from your Dezyn3D account
ACCESS_TOKEN = "YOUR_ACCESS_TOKEN" 
url = f"{API_BASE_URL}/v1/bulk_upload"

headers = {
    "X-Dezyn-Access-Token": ACCESS_TOKEN,
    "Content-Type": "application/json",
    "Accept": "application/json"
}

# This is an array of product objects
payload = [
    {
        "title": "Classic Leather Sneaker",
        "product_id": "SH-CL-001",
        "front_image_url": "https://example.com/sneaker_front (required)",
        "back_image_url": "https://example.com/sneaker_back (optional)",
        "left_image_url": "https://example.com/sneaker_left (optional)",
        "right_image_url": "https://example.com/sneaker_right (optional)"
    },
    {
        "title": "Another Product",
        "product_id": "SKU-456",
        "front_image_url": "https://example.com/image2"
    }
]

response = requests.post(url, headers=headers, json=payload)

print(response.status_code)
print(response.json())

Need a different language?

You can copy a code snippet above and ask an AI assistant (like ChatGPT, Gemini, or Claude) to convert it to your preferred programming language.