Photopea can be configured using a parameter after a hash sign. Such URL can be opened directly, or used as a src of an iframe . String value is encoded into the URL using classic encoding of query parameters (space as %20 etc.). It corresponds to encodeURIComponent() in Javascript or urlencode() in PHP. This string contains a JSON object. JSON configuration object JSON object must have the following structure: All parameters are optional. Data URIs can be used - file can be passed inside a request ( test ). files - array of files, that are loaded when Photopea starts resources - array of resources (gradients, brushes, fonts ...) server - parameters for saving documents back to a server version - the version of the API url - URL address of a server formats - formats, in which a document should be sent to a server. The string format corresponds to saveToOE . version - the version of the API url - URL address of a server formats - formats, in which a document should be sent to a server. The string format corresponds to saveToOE . environment - parameters of the environment, see Environment apis - some features are done by third parties. Enter your own API keys to use them. dezgo - Dezgo API key to unlock the Magic Replace and "Remove BG" with Dezgo dezgoURL - all Dezgo requests will go to a server specified by this URL, in the same format (same API). Works only if "dezgo" (above) is specified. dezgo - Dezgo API key to unlock the Magic Replace and "Remove BG" with Dezgo dezgoURL - all Dezgo requests will go to a server specified by this URL, in the same format (same API). Works only if "dezgo" (above) is specified. script - the script , that should be executed after loading each file (can be long) Saving to server When server parameter is specified in a request to Photopea.com, every document opened in Photopea will have the File - Save option. After a user clicks it, document data are sent to your server in a HTTP request using POST method.

Photopea will send binary data (a sequence of bytes) to your server, which has two parts: 2000 Bytes - JSON data the rest - one or more image files The JSON will have a following structure: source - if the file was loaded from your server, the value is the URL of this document. Otherwise (opening a local file, creating an empty file), it contains "local,X,NAME" , where X is the integer ID of the document, and NAME is the name of the document versions different versions of your document format - format of the file, exported from Photopea start, size - file offset and the size (relative, from the end of JSON) format - format of the file, exported from Photopea start, size - file offset and the size (relative, from the end of JSON) Here is a short PHP example, which accepts files from Photopea. After the server receives a file, it can send back a JSON response with optional String parameters: message - when specified, will be displayed to the user for a moment script - when specified, will be executed (e.g. you can call app.echoToOE("saved"); ) newSource - when specified, will be used as a new value of "source" for saving to a server in the future (can be useful, when a file was created within Photopea: "source" was "local,...") Cross-Origin Resource Sharing For security reasons, webapps can access only files from the same domain. In order to let Photopea load your file, the response of your server must contain the following header: Access-Control-Allow-Origin: * Find out more at CORS specification or at enable-cors.org . Prices Usage of Photopea API is completely free. Keep in mind, that PP is in early stages of development and there may be critical bugs. We do not take any responsibility for documents edited or generated by Photopea. If you want to hide advertisement and "colorful buttons", and use a whitelabel mode , look at Distributor account . Access-Control-Allow-Origin: * Find out more at CORS specification or at enable-cors.org . Prices Usage of Photopea API is completely free. Keep in mind, that PP is in early stages of development and there may be critical bugs. We do not take any responsibility for documents edited or generated by Photopea. If you want to hide advertisement and "colorful buttons", and use a whitelabel mode , look at Distributor account . Find out more at CORS specification or at enable-cors.org . Usage of Photopea API is completely free. Keep in mind, that PP is in early stages of development and there may be critical bugs. We do not take any responsibility for documents edited or generated by Photopea. If you want to hide advertisement and "colorful buttons", and use a whitelabel mode , look at Distributor account .