Planungs-APIAPI

Plane einen Beitrag mit einem Feld

Sende denselben Body wie zum sofortigen Veröffentlichen, ergänze einen schedule_at-Zeitstempel, und FoPost hält den Beitrag bis dahin in der Warteschlange. Alles bleibt bis zum Moment der Veröffentlichung bearbeitbar, und die Zustellung wird pro Konto gemeldet.

API-Schlüssel holenDoku lesen
POST /v1/posts
curl -X POST https://api.fopost.com/v1/posts \
  -H "X-API-Key: $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "workspace_id": "9b2f6c1e-...",
    "status": "scheduled",
    "schedule_at": "2026-09-01T09:00:00Z",
    "content": [{ "text": "Webhook retries are live. Read the changelog." }],
    "accounts": ["4a71d80b-...", "c30e9f12-..."]
  }'

Ein Zeitstempel

Jede zukünftige Zeit im Format ISO 8601. Die Warteschlange übernimmt und veröffentlicht planmäßig.

Bearbeitbar bis zum Versand

Ändere per PUT Text, Medien, Konten oder Zeit bei allem, was noch in der Warteschlange liegt.

Zustellung pro Konto

Sobald der Beitrag rausgeht, meldet jedes Konto seinen eigenen Status und Permalink.

Warteschlange

Plane eine Woche voller Beiträge in einem Skript

Gehe in einer Schleife durch deine Inhalte, wähle für jeden Eintrag eine Zeit und erstelle die Beiträge. Die Warteschlange läuft in FoPost, dein eigener Prozess kann also beendet werden, sobald der Request zurückkommt. Liste jederzeit die geplanten Beiträge auf, um zu sehen, was ansteht.

Posts-Referenz lesen
GET /v1/posts?status=scheduled
curl "https://api.fopost.com/v1/posts?workspace_id=9b2f6c1e-...&status=scheduled" \
  -H "X-API-Key: $API_KEY"

{
  "data": [
    { "id": "7d3e0a52-...", "status": "scheduled", "schedule_at": "2026-09-01T09:00:00Z", "accounts": [{ "id": "4a71d80b-...", "platform": "linkedin", "publish_status": "pending" }] },
    { "id": "8e4f1b63-...", "status": "scheduled", "schedule_at": "2026-09-02T09:00:00Z", "accounts": [{ "id": "c30e9f12-...", "platform": "twitter", "publish_status": "pending" }] }
  ],
  "meta": { "page": 1, "per_page": 30, "total": 2, "total_pages": 1 }
}

Nach Status filtern

Liste Entwürfe, geplante, veröffentlichte oder fehlgeschlagene Beiträge mit einem Query-Parameter auf.

Labels

Versieh jeden Beitrag mit einem Kampagnen-Label und filtere die Warteschlange danach.

Pro Workspace

Ein Schlüssel sieht einen Workspace, die Warteschlange eines Kunden vermischt sich also nie mit der eines anderen.

Anpassen

Verschieben, umschreiben oder abbrechen, bevor er rausgeht

Pläne ändern sich. Ändere per PUT Zeit, Text, Medien oder Zielkonten eines geplanten Beitrags. Brichst du ihn ab, wird er als abgebrochen markiert und nie zugestellt, oder du löschst ihn ganz. Gesperrt ist nichts, bis die Warteschlange ihn übernimmt.

PUT-Endpunkt ansehen
PUT /v1/posts/:id
curl -X PUT https://api.fopost.com/v1/posts/7d3e0a52-... \
  -H "X-API-Key: $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "schedule_at": "2026-09-01T14:00:00Z" }'

Neu planen

Ändere schedule_at, und die Warteschlange verschiebt den Beitrag auf die neue Zeit.

Inhalt austauschen

Ersetze das content-Array oder die Medien-IDs eines Beitrags in der Warteschlange.

Abbrechen oder löschen

Nimm einen Beitrag aus der Warteschlange, ohne etwas anderes darin anzufassen.

Bestätigen

Wisse, wann er angekommen ist, ganz ohne Polling

Wenn die geplante Zeit kommt, verteilt sich der Beitrag auf eine Zustellung pro Konto. Registriere einen Webhook, und delivery.published oder delivery.failed wird für jede einzelne ausgelöst, oder frag den Deliveries-Endpunkt ab, wenn du ein Pull-Modell bevorzugst.

Jetzt bauen
Ein Monat geplanter Beiträge im Veröffentlichungskalender

Webhook beim Abschluss

delivery.published enthält Beitrags-ID, Konto und Permalink.

Wiederholungen

Vorübergehende Netzwerkfehler werden mit Backoff wiederholt, bevor ein Fehlschlag gemeldet wird.

Analysen danach

Sobald der Beitrag live ist, liest dieselbe Beitrags-ID Impressionen und Engagement aus der Analytics API zurück.

Fragen zu Planungs-API, beantwortet

Wie weit im Voraus kann ich planen?

So weit du willst. Jeder zukünftige ISO-8601-Zeitstempel wird akzeptiert, und die Warteschlange hält den Beitrag bis dahin.

Welche Zeitzone nutzt schedule_at?

Sende einen ISO-8601-Zeitstempel in UTC, der auf Z endet. Der gesendete Wert ist der Wert, der gilt, auf dem Server findet keine Umrechnung statt.

Kann ich einen Beitrag nach dem Planen bearbeiten?

Ja. Ändere per PUT jedes Feld, auch die Zeit, solange der Beitrag noch nicht rausgegangen ist. Nach der Veröffentlichung wirken Änderungen auf den Datensatz, und mit Löschen entfernst du ihn aus einem Netzwerk.

Was passiert, wenn mein Server zum Veröffentlichungszeitpunkt ausfällt?

Nichts ändert sich. Die Warteschlange läuft in FoPost, nicht auf deiner Infrastruktur, der Beitrag geht also raus, egal ob dein Prozess läuft oder nicht.

Kann ich für nur einen Teil der Konten planen?

Ja. Das accounts-Array ist die Zielliste. Nimm nur die Konten auf, die den Beitrag erhalten sollen, und jedes bekommt einen eigenen Zustelldatensatz.

Gibt es ein Rate Limit?

Ja, 100 Requests pro Minute und Schlüssel. Eine Woche voller Beiträge in einem Skript zu planen passt bequem hinein.

Baue noch heute auf Planungs-API

Der Start ist kostenlos und die vollständige API inklusive. Erstelle einen Schlüssel und mach in wenigen Minuten deinen ersten Aufruf.

API-Schlüssel holen