POST https://api.usecommune.com/newsletters/{newsletter}/threads Production. There is no separate sandbox host.

Start a thread

Opens a new conversation in the newsletter's community and returns it. Needs content: write.

The thread is written by the person the credential belongs to, the same person createArticle credits, and readers see it exactly as if they had posted it in Commune. Subscribers are notified the way they are for any new thread, and an @username in the text mentions that person.

content is Markdown, as readers write it in Commune: plain text with light formatting, up to 5,000 characters. It is stored as sent. It can be left out when media attaches something, so a photo with no caption is a thread; a body with neither answers 400.

visibility decides where the thread can be read. subscribers, the default, keeps it inside the newsletter. public also puts it on Commune's global feed in the same write, which is what Put a thread on the global feed (POST /threads/{thread}/publish) does to a thread that already exists.

Publishes thread.created, and thread.published with source created_public when the thread is created public.

Path parameters

  • string Required

Request Headers

  • string Required
  • string

Body

object
Any of:
POST /newsletters/{newsletter}/threads
Loading...

Share your request

Use this link to easily share a pre-filled request of this operation. Everything you filled will be shared apart from the authentication fields.

Request URL

https://api-reference.usecommune.dev/explorer/operation/operation-createthread

Send a delete request

It looks like you’re about to send a DELETE request to this API. This type of request carries a risk of permanent and irreversible data loss.

Are you sure you want to continue?
Response
Waiting for a request to be sent.