---
title: "Create post"
method: POST
path: "/threads/create-post"
tags: ["Threads by Unshape"]
---

# Create post

`POST /threads/create-post`

Create a post from the request's body and publish it on Threads.

## Headers

- `X-Stripe-Email` string, required

## Request body

- ThreadsPost
  - `is_carousel_item` boolean — A boolean which tells if the current post will be a carousel or a simple post.
  - `image_url` string, uri — If the media_type is IMAGE, then this is the URL to the image.
  - `media_type` string, required — The post's type. Must be either "TEXT", "IMAGE" or "VIDEO".
  - `video_url` string — If the media_type is VIDEO, then this is the URL to the video.
  - `text` string, required — The post's text content
  - `tag` string — The hashtag you want to add to your post.
  - `access_token` string — The access token you got when calling https://api.unshape.app/threads/token

## Response `200`

Success - Post was successfully created in Threads

- ThreadsPostCreated
  - `success` boolean
  - `status` number

## Other responses

- `400` — Bad request - Invalid create post request

---

[API](https://skmtc.dev/unshape/apis/unshape-api.md) · [All operations](https://skmtc.dev/unshape/apis/unshape-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/unshape/unshape-api/revisions/25e25e454db5/schema)