---
title: "Upload an image for a webhook_image plugin"
method: POST
path: "/api/plugin_settings/{id}/image"
tags: ["Plugin Settings"]
---

# Upload an image for a webhook_image plugin

`POST /api/plugin_settings/{id}/image`

## Request

- Base URL: `https://trmnl.com`
- URL: `https://trmnl.com/api/plugin_settings/{id}/image`
- Auth: none declared

Send the image as JSON with the bytes in base64, or as the raw request body with its image Content-Type (not multipart form data). PNG, JPEG and WebP.

## Request body

- object
  - `image_base64` string, required: The image bytes, base64 encoded

## Response `200`

Full-color image on a color device

- object
  - `data` object
    - `message` string

## Other responses

- `401`: Numeric id without an API key
- `404`: Not found
- `422`: Image too large
- `429`: Rate limited

---

[API](https://skmtc.dev/trmnl/apis/trmnl-api.md) · [All operations](https://skmtc.dev/trmnl/apis/trmnl-api/llms.txt) · [OpenAPI document](https://skmtc.dev/trmnl/apis/trmnl-api/revisions/66179e6d663b?raw)