---
title: "Upload image by URL"
method: POST
path: "/images"
tags: ["Images"]
---

# Upload image by URL

`POST /images`

With this endpoint you can upload an image from a publicly accessible URL.
If the name is not provided, the filename will be extracted from the URL.

**Scopes:**
`images.write`

## Headers

- `Omnisend-Version` string, required

## Request body

- UploadURLRequest — UploadURLRequest contains payload for uploading an image by URL.
  - `name` string — Custom name for the image. If not provided, the filename will be extracted from the URL
  - `url` string, required — URL of the image to upload. Must be publicly accessible (HTTPS, PNG, JPEG, GIF, or WebP, max 5MB)

## Response `201`

Image uploaded

- Image — Image is an external image resource.
  - `createdAt` string — Image creation timestamp.
  - `height` integer — Image height in pixels.
  - `id` string — Unique image identifier.
  - `name` string — Image name.
  - `size` integer — Image size in bytes.
  - `type` string — MIME type of the image.
  - `url` string — Public CDN URL of the image.
  - `width` integer — Image width in pixels.

## Other responses

- `400` — Request contains invalid or missing fields
- `401` — Authentication is missing or invalid
- `403` — Insufficient permissions for this operation
- `410` — API version has been retired
- `429` — Rate limit exceeded
- `500` — Unexpected error occurred

---

[API](https://skmtc.net/omnisend/apis/events-api.md) · [All operations](https://skmtc.net/omnisend/apis/events-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/omnisend/events-api/versions/50214fbc283f/schema)