---
title: "Beitrag erstellen: 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/de/dokumentation/api/endpunkte/bejegyzes-letrehozas
source: https://posty.hu/de/dokumentation/api/endpunkte/bejegyzes-letrehozas.md
---

Beiträge

# Beitrag erstellen: POST /posts

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

## Der Pfad

Methode und Pfad

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

Berechtigung

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

operationId

`createPost`

Erstellt einen Entwurf, plant einen Beitrag oder veröffentlicht sofort, auf einem oder mehreren Kanälen. Das ist der einzige Schreib-Endpunkt, den eine Integration regelmäßig aufruft.

Wenn du eine bestehende Gruppen-ID schickst, aktualisiert er den vorhandenen Beitrag, statt einen zweiten anzulegen.

## Parameter

| Name | Ort | Typ | Pflicht | Was es tut |
| --- | --- | --- | --- | --- |
| type | törzs | "draft" \| "schedule" \| "now" | ja | Entwurf, Planung oder sofortige Veröffentlichung. schedule und now brauchen den Scope posts:publish. |
| date | törzs | ISO 8601 Datum | ja | Der Zeitpunkt der Veröffentlichung, in UTC. |
| shortLink | törzs | boolean | nein | Ob Posty die Links im Text kürzen soll. |
| tags | törzs | Array | nein | Interne Tags am Beitrag. Sie gehen nicht an die Plattform. Du filterst damit nur in Posty. |
| posts | törzs | Array | ja | Ein Eintrag pro Kanal. In jedem stehen die integration.id, das value-Array (der Beitrag und seine Kommentare) und optional die plattformspezifischen settings. |

## Anfrage

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

## Antwort

Beispiel für die Form der Antwort. Das verbindliche Schema, Feld für Feld, steht im [OpenAPI-Dokument](https://posty.hu/openapi.json).

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

Kód másolása

## Wichtig

- content erwartet HTML, keinen Klartext. Ein Absatz steht zwischen <p>…</p>.
- Das erste Element im value-Array ist der Beitrag, der Rest geht als Kommentare darunter raus. delay gibt in Minuten an, um wie viel später.
- Das Bild kommt aus der Mediathek: Lade zuerst über den Endpunkt /upload oder /upload-from-url hoch, und übergib den path-Wert aus der Antwort.
- settings.\_\_type ist die Plattform-ID. Die erwarteten Felder stehen im Einstellungsschema des Kanals.
- Die sofortige Veröffentlichung ist unumkehrbar und ruft externe Systeme auf. Schütze Netzwerkwiederholungen mit einem Idempotenzschlüssel.

## Siehe auch

- [Authentifizierung](https://posty.hu/de/dokumentation/api/authentifizierung): der Schlüssel und die Scopes.
- [Fehler und Limits](https://posty.hu/de/dokumentation/api/fehler): die Fehlerantworten und das Aufruflimit.
- [Alle Endpunkte](https://posty.hu/de/dokumentation/api/endpunkte): die vollständige Liste.

Dokumentationsseiten

Fehlt etwas auf dieser Seite? Schreib eine E-Mail an [norbert@posty.hu](mailto:norbert@posty.hu) oder nutze auf der [Hilfeseite](https://posty.hu/de/hilfe) das Formular.