---
title: "Vytvoření příspěvku: POST /posts | Posty dokumentáció"
description: "Poszt létrehozása: piszkozat, ütemezés vagy azonnali közzététel, egy vagy több csatornára."
canonical: https://posty.hu/cs/dokumentace/api/koncove-body/bejegyzes-letrehozas
source: https://posty.hu/cs/dokumentace/api/koncove-body/bejegyzes-letrehozas.md
---

Příspěvky

# Vytvoření příspěvku: POST /posts

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

## Cesta

Metoda a cesta

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

Oprávnění

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

operationId

`createPost`

Vytvoří koncept, naplánuje příspěvek, nebo ho hned publikuje, na jeden nebo víc kanálů. Je to jediný zapisovací endpoint, který integrace volá pravidelně.

Když pošlete existující identifikátor skupiny, aktualizuje stávající příspěvek, místo aby vytvořil druhý.

## Parametry

| Název | Umístění | Typ | Povinné | Co dělá |
| --- | --- | --- | --- | --- |
| type | törzs | "draft" \| "schedule" \| "now" | ano | Koncept, naplánování nebo okamžité publikování. schedule a now vyžadují oprávnění posts:publish. |
| date | törzs | ISO 8601 datum | ano | Čas publikování, v UTC. |
| shortLink | törzs | boolean | ne | Jestli má Posty zkrátit odkazy v textu. |
| tags | törzs | pole | ne | Interní štítky u příspěvku. Na platformu se neposílají, v Posty s nimi jen filtrujete. |
| posts | törzs | pole | ano | Jeden prvek na kanál. V každém je integration.id, pole value (příspěvek a jeho komentáře) a volitelně settings specifická pro platformu. |

## Požadavek

```
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" }
    }]
  }'
```

Kód másolása

## Odpověď

Příklad tvaru odpovědi. Závazné schéma, pole po poli, je v [dokumentu OpenAPI](https://posty.hu/openapi.json).

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

Kód másolása

## Důležité

- content očekává HTML, ne prostý text. Odstavec je mezi <p>…</p>.
- První prvek pole value je příspěvek, zbytek jde ven jako komentáře pod ním. delay říká v minutách, o kolik později.
- Obrázek pochází z knihovny médií: nejdřív ho nahrajte endpointem /upload nebo /upload-from-url a předejte hodnotu path z odpovědi.
- settings.\_\_type je identifikátor platformy. Očekávaná pole vypisuje schéma nastavení kanálu.
- Okamžité publikování je nevratné a volá externí systémy. Síťové opakování chraňte klíčem idempotence.

## Související

- [Autentizace](https://posty.hu/cs/dokumentace/api/overeni): klíč a scope.
- [Chyby a limity](https://posty.hu/cs/dokumentace/api/chyby): chybové odpovědi a limit volání.
- [Všechny endpointy](https://posty.hu/cs/dokumentace/api/koncove-body): kompletní seznam.

Stránky dokumentace

Něco vám na této stránce chybí? Napište na [norbert@posty.hu](mailto:norbert@posty.hu) nebo na stránce [Nápověda](https://posty.hu/cs/napoveda) vyplňte formulář.