Webinar Registrants Download URL

Generate a download URL for a webinar's registrants as a CSV file

Info

Required scope: stream.read

Warning

This method requires authentication

Generate a URL to download every registrant of a webinar event, with their live attendance, as a CSV file. Use it to import registrants into a CRM such as HubSpot or Marketo. The request takes no body.

curl -X POST \
     -H "Authorization: Bearer [access token]" \
     https://api.restream.io/v2/user/events/{eventId}/webinar/registrants/download-url

Path Parameters:

ParameterTypeDescription
eventIdstring (UUID)The UUID of the event (required)

Response

The returned downloadUrl is a tokenized link that works until expiresAt, one hour after it is issued. Fetch it directly to download the CSV — no Authorization header is required on that URL, so share it only with people who may see the registrants.

Success
Error (event not found)
Error (invalid token)
{
  "downloadUrl": "https://backend.events.restream.io/guest/webinar-registrations/csv?token=xxx",
  "expiresAt": "2026-11-11T11:53:54.000Z"
}

CSV file

The file is UTF-8 with a byte order mark, so spreadsheet apps read non-ASCII names correctly. It has one row per registrant, including those whose access was removed:

ColumnDescription
NameRegistrant's name
TitleRegistrant's job title
EmailRegistrant's email address
Registered at (UTC)When the person registered, as YYYY-MM-DD HH:MM:SS
AccessGranted, or Removed if the host removed the registrant's access
AttendedYes if the registrant joined live, otherwise empty
Joined at (UTC)The registrant's most recent live join, otherwise empty
Event nameTitle of the event
Event time (UTC)When the event went live, or its scheduled time
Name,Title,Email,Registered at (UTC),Access,Attended,Joined at (UTC),Event name,Event time (UTC)
Jane Doe,Head of Marketing,jane@example.com,2026-11-10 14:46:39,Granted,Yes,2026-11-10 14:48:20,Product Launch,2026-11-10 14:48:00
John Smith,,john@example.com,2026-11-10 14:50:05,Granted,,,Product Launch,2026-11-10 14:48:00
Info

An empty Attended cell means Restream has no attendance record for the registrant. Usually they did not join, but attendance can be missing for other reasons, such as webinars held before attendance tracking, so don't treat it as a confirmed no-show.