Content toevoegen aan een autolijst via de API

Bijgewerkt 4 weken geleden

Je kunt content aan een bestaande autolijst toevoegen via de API met twee aanroepen: maak eerst een lege plek in de lijst en vul die plek daarna met de tekst en media van je bericht. Dit werkt met elke HTTP-client, waaronder Postman, Make, n8n en Zapier.

Vereisten

Voor beide aanroepen heb je je userToken, userId, blogId en de interne ID van de autolijst nodig.

Waarde	Waar vind je die
`userToken`	Accountinstellingen > API-sectie > REST API-toegangstoken. Stuur deze mee in de requestheader `X-Mc-Auth`.
`userId`	De gebruikers-ID van je Metricool-account. Zie Je Metricool-gebruikers-ID vinden.
`blogId`	De identifier van het merk/profiel, zichtbaar in de URL van je browser wanneer je dat merk in Metricool gebruikt.
`listid`	De interne ID van de autolijst. Deze komt niet altijd overeen met de ID in de planner-URL (`/planner/autolist/{X}`) — controleer deze in de response van de aanroep in stap 1 in plaats van ervan uit te gaan.

Content toevoegen aan de autolijst

Een lege plek maken

Door een plek te maken reserveer je een positie in de autolijst. De response is de volledige array van de autolijst, inclusief de id van het nieuwe item — gebruik die waarde als postid in de volgende stap.

GET https://app.metricool.com/api/lists/posts/create?listid={listId}&position={position}&userId={userId}&blogId={blogId}

Veld	Beschrijving
`listid`	De interne ID van de autolijst.
`position`	Waar het nieuwe bericht moet worden ingevoegd. Met `0` voeg je het bovenaan de lijst in.

Elke aanroep naar dit endpoint voegt een nieuwe lege rij toe aan de autolijst, ook als je de volgende stap niet uitvoert. Bij herhaalde aanroepen ontstaan er steeds meer lege rijen — verwijder deze uit de autolijst met Alles verwijderen in de Metricool-planner.

De plek met content vullen

Stuur deze aanroep als form-data, niet als JSON.

POST https://app.metricool.com/api/lists/posts/updatepostlist?userId={userId}&blogId={blogId}

Veld	Waarde
`listid`	De interne ID van de autolijst.
`text`	De tekstinhoud van het bericht.
`postid`	De `id` die in de vorige stap is geretourneerd.
`pictures`	Een afbeeldings- of videobestand voor het bericht. Als er geen afbeelding is, stuur je `[]` mee — een lege waarde slaat de tekst op, maar zorgt ervoor dat de rest van de aanvraag stilzwijgend mislukt.

Problemen oplossen

500 InternalError: "Request method 'POST' is not supported"

Je hebt /api/lists/posts/create aangeroepen met POST. Dit endpoint accepteert alleen GET — wijzig de requestmethode in GET en behoud dezelfde queryparameters.

De aanvraag slaagt, maar het bericht ziet er niet goed uit

Als pictures leeg is verzonden in plaats van [], wordt de aanroep als geslaagd geretourneerd en wordt de text opgeslagen, maar mislukt de rest van de update stilzwijgend. Stuur de aanvraag opnieuw met pictures ingesteld op [] als er geen afbeelding is.

Gerelateerde informatie: Een endpoint in Metricool ophalen om API-aanroepen te doen en Veelgestelde vragen en fouten bij het gebruik van de API.

Was dit nuttig?