Planning-APIAPI

Plan een post in met één veld

Stuur dezelfde body als bij direct publiceren, voeg een schedule_at-timestamp toe en FoPost houdt de post tot dan in de wachtrij. Alles blijft bewerkbaar tot het moment dat de post uitgaat, en de levering wordt per account gemeld.

Haal je API-sleutel opLees de documentatie
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-..."]
  }'

Eén timestamp

Elke ISO 8601-tijd in de toekomst. De wachtrij pakt hem op en publiceert op schema.

Bewerkbaar tot verzending

Wijzig met PUT de tekst, media, accounts of tijd van alles wat nog in de wachtrij staat.

Levering per account

Zodra de post uitgaat, meldt elk account zijn eigen status en permalink.

Wachtrij

Plan een week aan posts in één script

Loop over je content, kies een tijd per item en maak de posts aan. De wachtrij draait in FoPost, dus je eigen proces kan stoppen zodra het request terugkomt. Vraag op elk moment de ingeplande posts op om te zien wat eraan komt.

Lees de posts-referentie
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 }
}

Filter op status

Vraag concepten en ingeplande, gepubliceerde of mislukte posts op met één queryparameter.

Labels

Tag elke post per campagne en filter de wachtrij op label.

Per werkruimte

Een sleutel ziet één werkruimte, dus de wachtrij van de ene klant raakt nooit vermengd met die van een andere.

Aanpassen

Verplaats, herschrijf of annuleer voordat hij uitgaat

Plannen veranderen. Gebruik PUT op een ingeplande post om de tijd, tekst, media of doelaccounts te wijzigen. Annuleer hem en hij wordt als geannuleerd gemarkeerd en nooit geleverd, of verwijder hem helemaal. Niets staat vast tot de wachtrij hem oppakt.

Bekijk het PUT-endpoint
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" }'

Opnieuw inplannen

Wijzig schedule_at en de wachtrij verplaatst de post naar de nieuwe tijd.

Content vervangen

Vervang de content-array of de media-id's van een post in de wachtrij.

Annuleren of verwijderen

Haal een post uit de wachtrij zonder iets anders aan te raken.

Bevestigen

Weet wanneer hij is aangekomen, zonder te pollen

Als de ingeplande tijd aanbreekt, splitst de post zich op in één levering per account. Registreer een webhook en delivery.published of delivery.failed gaat voor elk account af, of poll het deliveries-endpoint als je liever zelf ophaalt.

Begin met bouwen
Een maand aan ingeplande posts in de publicatiekalender

Webhook bij afronding

delivery.published bevat de post-id, het account en de permalink.

Nieuwe pogingen

Tijdelijke netwerkfouten worden met backoff opnieuw geprobeerd voordat er een fout wordt gemeld.

Analyses achteraf

Zodra de post live is, leest dezelfde post-id weergaven en engagement terug uit de Analytics API.

Vragen over Planning-API, beantwoord

Hoe ver vooruit kan ik inplannen?

Zo ver als je wilt. Elke toekomstige ISO 8601-timestamp wordt geaccepteerd, en de wachtrij houdt de post tot dan vast.

Welke tijdzone gebruikt schedule_at?

Stuur een ISO 8601-timestamp in UTC die eindigt op Z. De waarde die je stuurt, is de waarde die wordt gebruikt; op de server vindt geen conversie plaats.

Kan ik een post bewerken nadat ik hem heb ingepland?

Ja. Wijzig met PUT elk veld, ook de tijd, van een post die nog niet is uitgegaan. Na publicatie gelden bewerkingen voor het record, en met delete verwijder je hem van een netwerk.

Wat gebeurt er als mijn server down is op het publicatiemoment?

Dan verandert er niets. De wachtrij draait binnen FoPost, niet op jouw infrastructuur, dus de post gaat uit, of je proces nu draait of niet.

Kan ik inplannen voor een deel van de accounts?

Ja. De array accounts is de doellijst. Neem alleen de accounts op die de post moeten krijgen, en elk krijgt een eigen leveringsrecord.

Is er een rate limit?

Ja, 100 requests per minuut per sleutel. Een week aan posts inplannen in één script past daar ruim binnen.

Bouw vandaag nog op de Planning-API

Starten is gratis en de volledige API is inbegrepen. Maak een sleutel aan en doe binnen enkele minuten je eerste aanroep.

Haal je API-sleutel op