Firmreader Docsdocs

Create Post

POSThttps://api.firmreader.com/v1/posts

Publish a new post to a channel. The post is immediately visible to channel subscribers unless scheduled for a future time.

Authorizations

Authorizationstringheaderrequired

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

channel_idstringrequired

The ID of the channel to publish in.

titlestringrequired

Headline displayed in the feed and notifications.

bodystringrequired

The main content of the post. Supports Markdown formatting.

priority"normal" | "high" | "urgent"

Notification priority level. Urgent bypasses user preferences.

Allowed values: "normal" | "high" | "urgent"
Default: "normal"
tagsarray<string>

Tags for categorization and filtering.

scheduled_atstring<date-time>

ISO 8601 timestamp to schedule the post. If omitted, the post is published immediately.

cover_image_urlstring<uri>

URL of the cover image displayed at the top of the post.

Response

application/json

Post created successfully

idstring

Unique post identifier.

channel_idstring

Channel the post belongs to.

titlestring

Post headline.

bodystring

Post content in Markdown.

priority"normal" | "high" | "urgent"

Notification priority level.

Allowed values: "normal" | "high" | "urgent"
tagsarray<string>

Tags for categorization.

authorobject
author.idstring
author.namestring
author.emailstring
status"draft" | "scheduled" | "published" | "archived"

Current status of the post.

Allowed values: "draft" | "scheduled" | "published" | "archived"
published_atstring<date-time>

When the post was published.

scheduled_atstring<date-time>

Scheduled publish time, if applicable.

cover_image_urlstring<uri>
viewsinteger

Number of unique readers.

created_atstring<date-time>
updated_atstring<date-time>