Add playlist item (Admin)

POST/manage/playlists/:playlistId/items

Add a 4S event or an external link to the playlist. Set the type with kind: pass eventId for kind=FOUR_S_EVENT, or sourceUrl and title for kind=EXTERNAL_LINK. The display order is assigned automatically at the end.

Auth	Login required

Path parameters

playlistIdstringrequired

Playlist ID or slug.

Request body

kindstringrequired

FOUR_S_EVENT (a 4S event) or EXTERNAL_LINK (an external event).

eventIdstringoptional

Required when kind=FOUR_S_EVENT. Only published events can be added.

sourceUrlstringoptional

Required when kind=EXTERNAL_LINK. The external event URL (https only).

titlestringoptional

Required when kind=EXTERNAL_LINK. The event title; for kind=FOUR_S_EVENT the event's own title is used.

description / imageUrl / schedules / location / organizerNamemixedoptional

Additional fields for kind=EXTERNAL_LINK.

tagsstring[]optional

Array of tag names.

Response

Returns PlaylistItem.

Request

curl https://api.4s.link/manage/playlists/PLAYLIST_ID/items \
  -X POST \
  -H "Authorization: Bearer 4s_at_..." \
  -H "Content-Type: application/json" \
  -d '{
  "kind": "FOUR_S_EVENT",
  "eventId": "e1f2a3b4-..."
}'

Example response

{
  "id": "pi1a2b3-...",
  "title": "4S Tech Conference 2026",
  "type": "EVENT",
  "eventId": "e1f2a3b4-...",
  "externalUrl": null,
  "thumbnailUrl": "https://.../thumb.png",
  "order": 0
}