Posts

Create a post: POST /posts

Poszt létrehozása: piszkozat, ütemezés vagy azonnali közzététel, egy vagy több csatornára.

Path

Method and path

POSThttps://api.posty.hu/public/v1/posts

Authorization

posts:draft (közzétételhez posts:publish is)

operationId

createPost

Creates a draft, schedules a post, or publishes immediately, to one or more channels. This is the only write endpoint an integration calls regularly.

If you send an existing group ID, it updates the existing post instead of creating a second one.

Parameters

Name	Location	Type	Required	Description
type	törzs	"draft" \| "schedule" \| "now"	yes	Draft, schedule, or publish immediately. schedule and now require the posts:publish scope.
date	törzs	ISO 8601 date	yes	The publish time, in UTC.
shortLink	törzs	boolean	no	Whether Posty should shorten the links in the text.
tags	törzs	array	no	Internal tags on the post. They do not go out to the platform. You only use them to filter in Posty.
posts	törzs	array	yes	One item per channel. Each has the integration.id, the value array (the post and its comments), and optionally the platform-specific settings.

Request

curl -X POST https://api.posty.hu/public/v1/posts \
  -H "Authorization: psty_a_kulcsod" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "schedule",
    "date": "2026-09-15T09:00:00.000Z",
    "shortLink": false,
    "posts": [{
      "integration": { "id": "clx1a2b3c4d5e6f7g8h9" },
      "value": [
        { "content": "<p>Sziasztok!</p>", "image": [] },
        { "content": "<p>Az első hozzászólás.</p>", "image": [], "delay": 5 }
      ],
      "settings": { "__type": "x", "who_can_reply_post": "everyone" }
    }]
  }'

Response

Example response structure. The OpenAPI document contains the authoritative schema for each field.

[
  { "postId": "clp0s7t8u9v0w1x2", "integration": "clx1a2b3c4d5e6f7g8h9" }
]

Important

content expects HTML, not plain text. A paragraph lives between <p>…</p>.
The first item in the value array is the post. The rest go out as comments under it. delay is how many minutes later.
Images come from the media library: upload first with the /upload or /upload-from-url endpoint, then pass the path value from the response.
settings.__type is the platform ID. The expected fields are listed in the channel's settings schema.
Publishing immediately cannot be undone, and it calls external systems. Protect network retries with an idempotency key.

Authentication: API key and scopes.
Errors and limits: error responses and rate limits.
All endpoints: full list.

Is something missing from this page? Email [email protected] or use the form on the Help page.