---
title: "Bejegyzés létrehozása: 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/dokumentacio/api/vegpontok/bejegyzes-letrehozas
source: https://posty.hu/dokumentacio/api/vegpontok/bejegyzes-letrehozas.md
---

Bejegyzések

# Bejegyzés létrehozása: POST /posts

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

## Az útvonal

Metódus és útvonal

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

Jogosultság

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

operationId

`createPost`

Piszkozatot hoz létre, bejegyzést ütemez, vagy azonnal közzétesz, egy vagy több csatornára. Ez az egyetlen író végpont, amit egy integráció rendszeresen hív.

Ha meglévő csoportazonosítót küldesz, a meglévő bejegyzést frissíti, nem hoz létre másodikat.

## Paraméterek

| Név | Hol | Típus | Kötelező | Mit csinál |
| --- | --- | --- | --- | --- |
| type | törzs | "draft" \| "schedule" \| "now" | igen | Piszkozat, ütemezés vagy azonnali közzététel. A schedule és a now posts:publish jogosultságot kér. |
| date | törzs | ISO 8601 dátum | igen | A közzététel időpontja, UTC-ben. |
| shortLink | törzs | boolean | nem | Rövidítse-e a Posty a szövegben lévő linkeket. |
| tags | törzs | tömb | nem | Belső címkék a bejegyzésen. A platformra nem mennek ki, csak a Postyban szűrsz velük. |
| posts | törzs | tömb | igen | Csatornánként egy elem. Mindegyikben az integration.id, a value tömb (a bejegyzés és a hozzászólásai), és opcionálisan a platformspecifikus settings. |

## Kérés

```
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

## Válasz

Példa a válasz alakjára. A mezőnkénti, kötelező érvényű sémát az [OpenAPI dokumentum](https://posty.hu/openapi.json) tartalmazza.

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

Kód másolása

## Fontos

- A content HTML-t vár, nem sima szöveget. Egy bekezdés <p>…</p> között áll.
- A value tömb első eleme a bejegyzés, a többi hozzászólásként megy ki alá. A delay percben adja meg, mennyivel később.
- A kép a médiakönyvtárból való: előbb tölts fel a /upload vagy a /upload-from-url végponttal, és a válaszban kapott path értéket add át.
- A settings.\_\_type a platform azonosítója. A várt mezőket a csatorna beállítássémája sorolja fel.
- Az azonnali közzététel visszafordíthatatlan, és külső rendszereket hív. Idempotenciakulccsal védd a hálózati újrapróbálkozást.

## Kapcsolódó

- [Hitelesítés](https://posty.hu/dokumentacio/api/hitelesites): a kulcs és a scope-ok.
- [Hibák és korlátok](https://posty.hu/dokumentacio/api/hibak): a hibaválaszok és a hívási keret.
- [Minden végpont](https://posty.hu/dokumentacio/api/vegpontok): a teljes lista.

Dokumentációs oldalak

Hiányzik valami erről az oldalról? Írj a [norbert@posty.hu](mailto:norbert@posty.hu) címre, vagy használd a [Segítség](https://posty.hu/segitseg) oldal űrlapját.