---
title: "Upload artwork"
method: POST
path: "/creatives"
tags: ["Creatives"]
---

# Upload artwork

`POST /creatives`

## Request

- Base URL: `https://wall.marketing/api/v1`
- URL: `https://wall.marketing/api/v1/creatives`
- Auth: HTTP bearer

Upload the advert artwork from a public https image URL (PNG or JPEG) or base64. It is converted to the screen's 800 × 480 six-colour e-paper format (render bold, the default, for flat-colour graphics and text; smooth for photos; or auto) and checked for nudity and profanity. Returns a creative_id and an image of what the screen will show. Photos work; large, high-contrast words read best from a distance. Needs scope quote. Over HTTP the file (PNG or JPEG up to 10 MB, or a ready-made 192,000-byte panel file) can also be sent as multipart field "file" or as a raw image body.

## Headers

- `Idempotency-Key` string

## Request body

- object
  - `image_url` string, uri
  - `image_base64` string
  - `name` string
  - `fit` 'cover' | 'stretch'
  - `render` 'auto' | 'bold' | 'smooth'

## Response `201`

Created

- Creative
  - `object` string: Always "creative".
  - `id` string: The creative_id to book with.
  - `livemode` boolean: False in the sandbox.
  - `name` string, nullable: The name given at upload.
  - `status` string: Always "approved": artwork that fails the checks is refused at upload.
  - `source` string, nullable: How it arrived: image, or a ready-made panel file.
  - `original_type` string, nullable: The uploaded file's type.
  - `render` string, nullable: bold or smooth: how the image was converted to the panel's colours.
  - `checks` object: What was checked.
    - `format` string: The conversion done.
    - `content` string: Result of the nudity and profanity check.
  - `preview_url` string: PNG of exactly what the screen will show.
  - `created_at` string, nullable: When it was uploaded. ISO 8601, UTC.

## Other responses

- `400`: Error
- `401`: Error
- `403`: Error
- `404`: Error
- `409`: Error
- `413`: Error
- `415`: Error
- `422`: Error
- `429`: Error

---

[API](https://skmtc.dev/wall/apis/wall-marketing-platform-api.md) · [All operations](https://skmtc.dev/wall/apis/wall-marketing-platform-api/llms.txt) · [OpenAPI document](https://skmtc.dev/wall/apis/wall-marketing-platform-api/revisions/290b284951e3?raw)