Articles on: How to

EventLive API Documentation

Create an Event



PUT https://api.eventlive.pro/event

Headers:
Authorization YOURAPIKEY (Notice, no Bearer before API key)
Content-Type application/json

Payload:
{
    "title": "New Event",
    "event_datetime_utc": "2021-02-22T00:00:00Z",
    "event_timezone": "America/Chicago",
    "event_location": "Venue name, city, or address",
    "event_cover_path": "https://eventliveprod-posters.s3.amazonaws.com/eventlive_default_test_event.jpg"
}

For event cover path 1280x720 cropping is advised.

Response example:
{
    "id": "a75aaac1-251d-4548-8077-c798fb1edce0",
    "slug": "new-event-3",
    "broadcaster": "yourusername",
    "title": "New Event 3",
    "event_create_datetime": "2021-02-18T20:20:36Z",
    "event_datetime_utc": "2021-02-22T00:00:00Z",
    "event_window_start_datetime_utc": "2021-02-18T19:20:36Z",
    "event_window_end_datetime_utc": "2021-02-19T19:20:36Z",
    "event_location": "Some place",
    "event_timezone": "America/Chicago",
    "event_cover_path": "https://eventliveprod-posters.s3.amazonaws.com/eventlive_default_test_event.jpg",
    "event_status": "upcoming",
    "event_privacy": "unlisted",
    "is_published": true,
    "stream_key": "YKZFUPLH",
    "is_test": false,
    "stream_id": null,
    "alias": null,
    "url": "https://evt.live/yourusername/new-event-3"
}


Note that if is_published is returned as false it means you may have ran out of credits and the event is unpublished, and in preview mode (streaming will not work).


Retrieve Event Details



GET https://api.eventlive.pro/event/YKZFUPLH

Response example:
{
    "username": "joe7408",
    "event": {
        "id": "a75aaac1-251d-4548-8077-c798fb1edce0",
        "slug": "new-event-3",
        "broadcaster": "yourusername",
        "title": "New Event 3",
        "event_create_datetime": "2021-02-18T20:20:36Z",
        "event_datetime_utc": "2021-02-22T00:00:00Z",
        "event_window_start_datetime_utc": "2021-02-18T19:20:36Z",
        "event_window_end_datetime_utc": "2021-02-19T19:20:36Z",
        "event_location": "Some place",
        "event_timezone": "America/Chicago",
        "event_cover_path": "https://pbs.twimg.com/media/EuhfSt3VgAcnZd0?format=jpg&name=medium",
        "event_status": "upcoming",
        "event_privacy": "unlisted",
        "is_published": true,
        "stream_key": "YKZFUPLH",
        "is_test": false,
        "liveCount": null,
        "guestsCount": 0,
        "stream_id": null,
        "alias": null,
        "url": "https://evt.live/yourusername/new-event-3"
    }
}

Updated on: 04/03/2022