PSD Upload API

Upload a PSD file

Uploads a PSD file and optionally creates a mockup template.

POSThttps://app.dynamicmockups.com/api/v1/psd/upload

Authorization

apiKeyAuth

Header parameters

Body

application/json

psd_file_url*string

The URL to the PSD file.

Example: "https://drive.google.com/uc?export=download&id=11Low2n7A8_GeMWQkRXmmGXTOJOewRW4Q"

psd_namestring

An optional name for the PSD file.

Example: "My custom name"

psd_category_idinteger

An optional category ID for the PSD file.

Example: 3

mockup_templateobject

Optional settings for creating a mockup template after the PSD upload.

Response

200400401

Successful PSD upload operation.

Body

application/json

dataarray of any

successboolean

Indicates if the PSD upload operation was successful.

Example: true

messagestring

A message about the PSD upload operation.

Example: "PSD uploaded successfully"

Request

JavaScriptCurlPython

const response = await fetch('https://app.dynamicmockups.com/api/v1/psd/upload', {
    method: 'POST',
    headers: {
      "Accept": "application/json",
      "x-api-key": "text",
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "psd_file_url": "https://drive.google.com/uc?export=download&id=11Low2n7A8_GeMWQkRXmmGXTOJOewRW4Q"
    }),
});
const data = await response.json();

Response

200

{
  "data": [],
  "success": true,
  "message": "PSD uploaded successfully"
}

psd_category_id

If you do not provide this optional parameter, your uploaded PSD file will automatically be assigned to the default "Other" category.

This is the list of available PSD Category IDs at this moment:

        {
            "id": 1,
            "name": "T-shirts",
        },
        {
            "id": 2,
            "name": "Hoodies",    
        },
        {
            "id": 3,
            "name": "Wall Art",
        },
        {
            "id": 4,
            "name": "Mugs",
        },
        {
            "id": 5,
            "name": "Sweatshirts",
        },
        {
            "id": 6,
            "name": "Other", //default category if not provided as psd_category_id
        },
        {
            "id": 7,
            "name": "Pillows",
        },
        {
            "id": 8,
            "name": "Tote Bags",
        },
        {
            "id": 9,
            "name": "Phone Cases",
        },
        {
            "id": 10,
            "name": "Blankets",
        }

mockup_template.create_after_upload

If you are subscribed to our PRO plans and have uploaded your own Photoshop files using our web application, you know that after uploading PSD files you need to create a Mockup first from the uploaded PSD file and then use Mockup UUID and all other Mockup components via Render API.

Now you can fully automate this flow!

If you provide mockup_template.create_after_upload: true A mockup will be automatically created from the uploaded PSD file and our API will return in response a lot of useful data regarding the created mockup.

After mockup creation is successful, use the Mockup UUID and Smart Object UUIDs field to render images automatically using our Render API.

Response example

{
    "data": {
        "uuid": "65c10d09-6724-4026-89a4-2cbf00f8670f", //Mockup UUID
        "name": "My mockup automatically created after PSD upload",
        "thumbnail": "https://app-design-copilot-localhost.s3.eu-central-1.amazonaws.com/mockup/251/thumbnail.webp",
        "smart_objects": [
            {
                "uuid": "c39de536-7255-40d4-9458-6215355a5e30",
                "name": "T-shirt"
            },
            {
                "uuid": "2574e3aa-74a3-4fee-b10d-aa3721f2ee26",
                "name": "Background"
            }
        ],
        "collections": []
    },
    "success": true,
    "message": ""
}

This created Mockup will regularly show as any other created mockup in the web application. You can even fetch it using the Get Mockups API when you need it.

mockup_template.collections

You probably noticed the collections field that has an empty array from the previous example.

You can create collections in our web application and use the Get Collections API to retrieve collections.

You may provide a collections optional field to the PSD Upload API to automatically put the created mockup in the collections array of strings which will be returned in the PSD Upload API response as well instead of an empty array.

Please note that if you want to add the mockup to the collections automatically after the PSD Upload, you must set mockup_template.create_after_upload to true