Add playlist item

POST/manage/playlists/:playlistId/items

Add an event or external link to the playlist. Specify eventId for a 4S event, or externalUrl for an external link.

AuthLogin required

Path parameters

playlistIdstringrequired

Playlist ID or slug.

Request body

eventIdstring

Event ID to add; specify either this or externalUrl, not both.

externalUrlstring

External link URL; must be a valid URL. Specify either this or eventId, not both.

titlestring

Playlist title; required on create.

descriptionstring

Description.

thumbnailUrlstring

Thumbnail image URL.

ordernumber

Display order; an integer.

Request
curl https://api.4s.link/manage/playlists/PLAYLIST_ID/items \
-X POST \
-H "Authorization: Bearer 4s_at_..." \
-H "Content-Type: application/json" \
-d '{
"eventId": "e1f2a3b4-..."
}'
Example response
{
"id": "pi1a2b3-...",
"title": "4S Tech Conference 2026",
"type": "EVENT",
"eventId": "e1f2a3b4-...",
"externalUrl": null,
"thumbnailUrl": "https://.../thumb.png",
"order": 0
}