---
title: "Vytvoření příspěvku: POST /posts | Dokumentace Posty"
description: "Vytvoří příspěvek: koncept, naplánovaný nebo okamžitě publikovaný, na jeden či více kanálů."
canonical: https://posty.hu/cs/dokumentace/api/koncove-body/vytvoreni-prispevku
source: https://posty.hu/cs/dokumentace/api/koncove-body/vytvoreni-prispevku.md
---

Příspěvky

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

Vytvoří příspěvek: koncept, naplánovaný nebo okamžitě publikovaný, na jeden či více kanálů.

## Cesta

Metoda a cesta

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

Oprávnění

`posts:draft (pro publikování také posts:publish)`

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ělo | "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ělo | ISO 8601 datum | ano | Čas publikování, v UTC. |
| shortLink | tělo | boolean | ne | Jestli má Posty zkrátit odkazy v textu. |
| tags | tělo | pole | ne | Interní štítky u příspěvku. Na platformu se neposílají, v Posty s nimi jen filtrujete. |
| posts | tělo | 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_vas_klic" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "schedule",
    "date": "2026-09-15T09:00:00.000Z",
    "shortLink": false,
    "posts": [{
      "integration": { "id": "clx1a2b3c4d5e6f7g8h9" },
      "value": [
        { "content": "<p>Dobrý den všem!</p>", "image": [] },
        { "content": "<p>První komentář.</p>", "image": [], "delay": 5 }
      ],
      "settings": { "__type": "x", "who_can_reply_post": "everyone" }
    }]
  }'
```

Kopírovat kód

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

Kopírovat kód

## 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ář.