---
title: "Send an image reply to a creator"
method: POST
path: "/creator-messages/conversations/{creator_handle}/reply/image"
tags: ["Creator Messages"]
---

# Send an image reply to a creator

`POST /creator-messages/conversations/{creator_handle}/reply/image`

Send a TikTok IMAGE message. Provide an HTTPS `image_url`; we fetch it server-side, upload to TikTok, and dispatch into the existing conversation. Same auth/scope/idempotency/rate-limit/X-Dry-Run semantics as the text reply. v1: no caption (send a text reply separately if you also want copy).

## Path parameters

- `creator_handle` string, required

## Headers

- `Idempotency-Key` string, nullable
- `X-Dry-Run` string, nullable

## Request body

- CreatorReplyImageRequest
  - `image_url` string, required — HTTPS URL of an image to forward to the creator. We fetch it server-side (must resolve to a public IP, return Content-Type image/*, ≤ 5 MB), then upload to TikTok and dispatch.

## Response `200`

Dry-run — validated and echoed, nothing fetched or sent.

- CreatorReplyImageDryRunResponse
  - `dry_run` boolean
  - `would_send_to` string, required
  - `image_url` string, required

## Other responses

- `201` — Image uploaded to TikTok and reply sent to the creator.
- `400` — Invalid image_url (scheme, IP, content-type, or size).
- `403` — API key lacks `read_write` scope.
- `404` — No existing conversation with this creator.
- `422` — Validation Error
- `429` — Write rate limit exceeded.
- `502` — Image fetch failed, or TikTok rejected the send.

## Changes

> 26 revisions in range; 1 not diffed.

- **2026-09-19** `291230805105` — 1 info
  - api operation id `reply_to_creator_image_creator_messages_conversations__creator_handle__reply_image_post` removed and replaced with `creator_messages_reply_image`

[Change history](https://skmtc.dev/reacherapp/apis/reacher-data-api/changes/creator-messages/conversations/:creator_handle/reply/image/post.md)

---

[API](https://skmtc.dev/reacherapp/apis/reacher-data-api.md) · [All operations](https://skmtc.dev/reacherapp/apis/reacher-data-api/llms.txt) · [OpenAPI document](https://skmtc.dev/reacherapp/apis/reacher-data-api/revisions/c8958a7038ec?raw)