Submit an event

POST/playlists/:playlistId/item-requests

Submit an event to a playlist. The item is created with status=PENDING and stays hidden until a community admin approves it. Approval and rejection are done through the /manage/playlists endpoints.

Auth	Login required

Path parameters

playlistIdstringrequired

Playlist ID.

Request body

kindstringrequired

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

eventIdstring

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

sourceUrlstring

Required when kind=EXTERNAL_LINK. The external event URL.

titlestring

Required when kind=EXTERNAL_LINK. The event title.

description / imageUrl / schedules / location / organizerNamemixed

Additional fields for kind=EXTERNAL_LINK.

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

Example response
{
  "item": {
    "id": "it1-...",
    "playlistId": "pl1-...",
    "kind": "FOUR_S_EVENT",
    "status": "PENDING",
    "eventId": "e1f2a3b4-...",
    "title": "4S Tech Conference 2026"
  }
}