Add Image

POSThttps://api.inboxjot.com/v1/images

Adds an uploaded image to the media library. Send the key from Create Image Upload URL. To use an image that is already online, put its URL straight into the email's content. Needs a Full key. A key limited to one domain answers 403. Send an optional Idempotency-Key header to retry safely. See Idempotency.

Inboxjot stores the image as you send it, so resize it first. Keep it 1,200 pixels wide or less and under 1 MB.

POST/v1/images

curl -X POST https://api.inboxjot.com/v1/images \
  -H "Authorization: Bearer $INBOXJOT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "key": "image-uploads/ws_06d2mfk8r1/0b9e6e5a-3c1f-4c55-9d3a-6f0d2a7c1e44",
    "file_name": "hero.png"
  }'

{
  "id": "img_06d2mfk8r3wn5gt7kc2pb",
  "file_name": "hero.png",
  "url": "https://images.inboxjot-cdn.com/media/ws_06d2mfk8r1/i/3f9a2c1b7e4d6a05.png",
  "content_type": "image/png",
  "size_bytes": 412000,
  "width": 1200,
  "height": 630,
  "creator_name": null,
  "created_at": "2026-10-30T09:00:00.000Z"
}

Added the image.

Body Parameters

keystringrequired

The key from Create Image Upload URL.

file_namestring | null

The file name, up to 255 characters. Defaults to image.

Response

idstring

The image id.

file_namestring

The file name.

urlstring | null

The hosted URL to use in an img tag.

content_typestring

image/png, image/jpeg or image/gif.

size_bytesinteger

The size in bytes.

widthinteger

The width in pixels.

heightinteger

The height in pixels.

creator_namestring | null

The team member who uploaded it.

created_atstring

When it was added.

Responses

curl -X POST https://api.inboxjot.com/v1/images \ -H "Authorization: Bearer $INBOXJOT_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "key": "image-uploads/ws_06d2mfk8r1/0b9e6e5a-3c1f-4c55-9d3a-6f0d2a7c1e44", "file_name": "hero.png" }'

{ "id": "img_06d2mfk8r3wn5gt7kc2pb", "file_name": "hero.png", "url": "https://images.inboxjot-cdn.com/media/ws_06d2mfk8r1/i/3f9a2c1b7e4d6a05.png", "content_type": "image/png", "size_bytes": 412000, "width": 1200, "height": 630, "creator_name": null, "created_at": "2026-10-30T09:00:00.000Z" }