Skip to main content
POST
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 Complete an upload to finalize the asset.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
contentType
string
required

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

Example:

"image/png"

contentLength
integer
required

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

Example:

102400

Response

Pre-signed upload URL created.

emailAssetId
string
required

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

presignedUrl
string
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.

Last modified on July 20, 2026