OMomnisend
Images

Upload image file

With this endpoint you can upload an image file directly from your computer.

File Requirements:

  • Supported formats: JPEG, PNG, GIF, WebP
  • Maximum file size: 5MB

Scopes: images.write

Rate Limiting: This endpoint is rate limited to 400 requests per minute.

post/images/upload

Request

  • Base URL
    https://api.omnisend.com/api
  • URL
    https://api.omnisend.com/api/images/upload
  • Auth
    • OAuth 2
      Client credentials
      Token URL: https://app.omnisend.com/oauth2/token scopes: images.write
    • or API key in header Authorization

Headers

Omnisend-Versionstring required

API version that specifies the response format and behaviour

Request body multipart/form-data

filestring binary required

Image file to upload (JPEG, PNG, GIF, or WebP, max 5MB)

namestring

Custom name for the image. Defaults to the filename if not provided

Response

Image uploaded

createdAtstring

Image creation timestamp.

heightinteger

Image height in pixels.

idstring

Unique image identifier.

namestring

Image name.

sizeinteger

Image size in bytes.

typestring

MIME type of the image.

urlstring

Public CDN URL of the image.

widthinteger

Image width in pixels.

Example response

{
  "createdAt": "2026-01-15T10:30:00Z",
  "height": 1080,
  "id": "507f1f77bcf86cd799439011",
  "name": "my-image",
  "size": 102400,
  "type": "image/jpeg",
  "url": "https://cdn.example.com/image.jpg",
  "width": 1920
}

Changes

No recorded changes to this operation across all 1 revision of this API.