How to generate mockups with an API?

The MockupLaunch API allows you to generate mockups programmatically.

PHP examples are provided throughout our API documentation. However, calls to the MockupLaunch API can also be made via various other libraries.

Before you start

To complete the actions presented below, you must have:

Generate mockup request

use GuzzleHttp\Client;

//  Your API access token
$token = "my-secret-token";

//  API endpoint URL
$endpoint = "https://mockuplaunch.com/api/v1/mockup/266fa483-f8c0-4a97-aed3-dd09c7e89e7d";

//  Control the placement of the artwork in the mockup area
$options = [
    "design" => [
        "x" => 100,
        "y" => 100,
        "zoom" => 0.8,
    ]
];

//  Create API request
$request = (new Client())->post($endpoint, [
    "headers" => [
        "Accept" => "application/json",
        "Authorization" => "Bearer ".$token,
    ],
    "multipart" => [
        [
            "name" => "design",
            "contents" => fopen("/path/file.jpg", "r"),
            "filename" => "file.jpg",
        ],
        [
            "name" => "options",
            "contents" => json_encode($options),
        ]
    ]
]);

//  Get mockup from the response
$response = $request->getBody()->getContents();

Response

API response format is JSON

{
    "mockup": "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"
}
Feel free to contact us if you have any questions regarding the API implementation.

About

Arnd-Jan (pronounced AJ) is a software engineer and founder of MockupLaunch.

Driven by a fascination for automation and scalable solutions. He combines his tech skills with entrepreneurial experience as a print-on-demand seller, helping businesses streamline creative workflows and grow efficiently.

Want product news and updates? Sign up for our newsletter.

We care about your data. Read our privacy policy.