Sign in
Uploads

Create an upload

Request a pre-signed URL to upload an image asset. Upload the file with an HTTP PUT to the returned presignedUrl (sending the same Content-Type and Content-Length), then call /uploads/{emailAssetId}/complete to finalize the asset.

post/v1/uploads

Request body

contentTypestring required

The MIME type of the file to upload. Supported types are image/jpeg, image/png, image/gif and image/webp.

contentLengthinteger required

The size of the file in bytes. Must be a positive integer no greater than 4,000,000 bytes.

Example request

{
  "contentType": "image/png",
  "contentLength": 102400
}

Response

Pre-signed upload URL created.

emailAssetIdstring required

The ID of the created asset. Pass this as emailAssetId to /v1/uploads/{emailAssetId}/complete once the file has been uploaded.

presignedUrlstring required

The pre-signed URL to upload the file to with an HTTP PUT request. Send the same Content-Type and Content-Length used in the create request.

Changes