---
title: "Create an image post"
method: POST
path: "/posts/image"
tags: ["Posts"]
---

# Create an image post

`POST /posts/image`

## Request

- Base URL: `https://doomscrollr.com/api/v1`
- URL: `https://doomscrollr.com/api/v1/posts/image`
- Auth: HTTP bearer

## Request body

- object
  - `image` string, uri, required
  - `title` string
  - `description` string
  - `tags` string
  - `status` 'published' | 'draft' | 'scheduled'
  - `publish_at` string, date-time: Future publish time. When provided, status is set to scheduled.
  - `shoppable` boolean: Show a buy button on this image post

## Response `201`

Post created

- Post
  - `id` integer
  - `url` string
  - `title` string
  - `description` string
  - `image` string, uri
  - `status` 'published' | 'draft' | 'scheduled'
  - `post_type` string
  - `created_at` string, date-time
  - `publish_at` string, date-time, nullable

## Other responses

- `429`: Monthly API rate limit exceeded

---

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