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