Livestorm comes with a native Webhooks integration, which allows you to send your registrant and event data to any URL of your choice.
Webhooks
Our Webhooks integration allows you to send Livestorm data via webhooks to the URLs of your choice.
Many automation scenarios can be done like adding new registrants to a Google Sheet, sending a Slack notification after an event ends, sending the replay of an event to the people who couldn't attend, and more! The list is endless.
Our REST API also provides a way to manage webhooks, which are slightly more advanced (new triggers and extended body payloads). Don’t hesitate to check them out in our developers hub!
In this article
Add a Webhook#
1Go to your Settings menu and then Account settings.
2Click on Apps and select the Webhooks card.
3Click on Setup integration and then on Add a webhook.
4Choose the trigger and copy the URL of your choice.
5And click on Add a webhook.
6You can Edit your webhooks and Delete them.
Unlike our other native integrations, the Webhooks integration will apply to all of your events. So you won't have to activate this integration for an event specifically. You can filter and choose which kind of data you'd like to keep through your own system once you receive the data.
The 6 Triggers We Provide#
We provide the following 6 triggers:
Event created: when a new event is created
Session created: when a session is scheduled
Event is Published: when an event is published
New registrant: when someone registers for an event session
Event starts: when an event session starts
Event ends: when an event session ends
Livestorm Tip 👉 You can also test your webhooks and visualize the data that is sent out by using this app: https://webhook.site/.
Here are some examples of the JSON we send out for these 6 triggers:
Event created#
{
"data": {
"id": "29e88fxb-7370-47ce-9589-a691c7l272of",
"type": "events",
"attributes": {
"title": "New event webhook",
"slug": "new-event-webhook",
"registration_link": "https://app.livestorm.co/p/79e88fxb-6370-47ce-9589-a691c7l272of",
"estimated_duration": 30,
"registration_page_enabled": true,
"everyone_can_speak": false,
"description": null,
"status": "draft",
"light_registration_page_enabled": true,
"recording_enabled": true,
"recording_public": true,
"show_in_company_page": false,
"chat_enabled": true,
"polls_enabled": true,
"questions_enabled": true,
"language": "en",
"published_at": 0,
"scheduling_status": "draft",
"created_at": 1643710217,
"updated_at": 1643710219,
"owner": {
"id": "a850c828-b9a0-416d-ae13-8b672bch11e2",
"type": "people",
"attributes": {
"role": "team_member",
"created_at": 1599990459,
"updated_at": 1643710219,
"timezone": "Europe/Paris",
"first_name": "James",
"last_name": "Doe",
"email": "james.doe@livestorm.co",
"avatar_link": null
}
},
"sessions_count": 1,
"fields": [{
"id": "email",
"type": "text",
"order": 0,
"required": true
}, {
"id": "first_name",
"type": "text",
"order": 1,
"required": true
}, {
"id": "last_name",
"type": "text",
"order": 2,
"required": true
}]
},
"meta": {
"webhook": {
"id": "b836c804-8696-4946-a8c8-ece61da0ecd6",
"event": "event.created"
}
}
}
}Session created#
{
"data": {
"id": "1e9d9b14-f990-4e19-a436-9a7dd6a5780a",
"type": "sessions",
"attributes": {
"event_id": "71cfa73b-6fbe-4f55-b219-28f4b195ae94",
"status": "draft",
"timezone": "Europe/Paris",
"room_link": "https://app.livestorm.co/p/71cfa73b-6fbe-4f55-b219-28f4b195ae94/live?s=1e9d9b14-f990-4e19-a436-9a7dd6a5780a",
"attendees_count": 0,
"duration": null,
"estimated_started_at": 1645459200,
"started_at": 0,
"ended_at": 0,
"canceled_at": 0,
"created_at": 1644845096,
"updated_at": 1644845096,
"registrants_count": 1,
"breakout_room_parent_session_id": null
},
"meta": {
"webhook": {
"id": "86c06b1c-440e-4693-90bc-f68ba21036f3",
"event": "session.created"
}
}
}
}Event is Published#
{
"webinar": {
"identify": "a695b8cb-8467-4a95-b259-75b622bd91b0",
"title": "Product demo",
"slug": "product-demo",
"created_at": "2021-05-18T08:43:25.304Z",
"estimated_duration": 1800,
"registration_link": "https://app.livestorm.co/p/a695b8cb-8467-4a95-b259-75b622bd91b0",
"published_at": "2021-05-18T08:43:31.433Z",
"nb_registered": null
}
}New registrant#
{
"attendee": {
"identify": "13q82e6b-c6a2-497d-acfd-0cb2d00b6636",
"created_at": "2021-03-12T09:26:43.700Z",
"first_name": "John",
"last_name": "Doe",
"email": "john@doe.com",
"avatar_link": null,
"referrer": null,
"utm_source": null,
"utm_medium": null,
"utm_term": null,
"utm_content": null,
"utm_campaign": null,
"browser_version": "90.0.4430.93",
"browser_name": "Chrome",
"os_name": "Macintosh",
"os_version": "10.15.7",
"screen_height": "900",
"screen_width": "1440",
"ip_city": "Paris",
"ip_country_code": "FR",
"ip_country_name": "France",
"password_key": "w68d21e717ae84ec4915d4",
"fields": {},
"connection_link": "https://app.livestorm.co/p/a695b8cb-8467-4a95-b259-75b622bd91b0/live?email=john%40doe.com&key=w68d21e717ae84ec4915d4"
},
"webinar": {
"identify": "a695w8cb-8467-4a95-b259-75b622bd91b0",
"title": "Product demo",
"slug": "product-demo",
"created_at": "2021-05-18T08:43:25.304Z",
"estimated_duration": 1800,
"registration_link": "https://app.livestorm.co/p/a695b8cb-8467-4a95-b259-75b622bd91b0",
"published_at": "2021-05-18T08:43:31.433Z",
"nb_registered": 2,
"room_link": "https://app.livestorm.co/p/a695b8cb-8467-4a95-b259-75b622bd91b0/live?s=fqa1475e-fe2d-4egd-a007-6c27364bfeba",
"estimated_started_at": "2021-05-18T10:00:00.000Z"
}
}Event starts#
{
"webinar": {
"identify": "a695b8cb-8467-4a95-b259-75b622bd91b0",
"title": "Product demo",
"slug": "product-demo",
"created_at": "2021-05-18T08:43:25.304Z",
"estimated_duration": 1800,
"registration_link": "https://app.livestorm.co/p/a695b8cb-8467-4a95-b259-75b622bd91b0",
"published_at": "2021-05-18T08:43:31.433Z",
"nb_registered": 2,
"room_link": "https://app.livestorm.co/p/a695b8cb-8467-4a95-b259-75b622bd91b0/live?s=w0a1475e-fe2d-4wad-a007-6c27364bfeba",
"estimated_started_at": "2021-05-18T10:00:00.000Z",
"started_at": "2021-05-18T08:46:33.377Z"
}
}Event ends#
{
"webinar": {
"identify": "a695b8cb-8467-4a95-b259-75b622bd91b0",
"title": "Product demo",
"slug": "product-demo",
"created_at": "2021-05-18T08:43:25.304Z",
"estimated_duration": 1800,
"registration_link": "https://app.livestorm.co/p/a695b8cb-8467-4a95-b259-75b622bd91b0",
"published_at": "2021-05-18T08:43:31.433Z",
"nb_registered": 2,
"room_link": "https://app.livestorm.co/p/a695b8cb-8467-4a95-b259-75b622bd91b0/live?s=w0a1475e-fe2d-4wad-a007-6c27364bfeba",
"estimated_started_at": "2021-05-18T10:00:00.000Z",
"started_at": "2021-05-18T08:46:33.377Z",
"ended_at": "2021-05-18T08:48:04.528Z",
"duration": 91,
"nb_attended": 1,
"attendees": [
{
"identify": "13982e6b-c6a2-497d-acfd-0cb2d00b6636",
"created_at": "2021-03-12T09:26:43.700Z",
"first_name": "John",
"last_name": "Doe",
"email": "john@doe.com",
"avatar_link": null,
"referrer": null,
"utm_source": null,
"utm_medium": null,
"utm_term": null,
"utm_content": null,
"utm_campaign": null,
"browser_version": "90.0.4430.93",
"browser_name": "Chrome",
"os_name": "Macintosh",
"os_version": "10.15.7",
"screen_height": "900",
"screen_width": "1440",
"ip_city": "Paris",
"ip_country_code": "FR",
"ip_country_name": "France",
"password_key": "e68s21e717be84ec4915d4",
"fields": {},
"connection_link": "https://app.livestorm.co/p/a695b8cb-8467-4a95-b259-75b622bd91b0/live?email=pierre%2Bregistrant1%40livestorm.co&key=e68s21e717be84ec4915d4",
"is_attendance": true,
"attendance_rate": 100,
"attendance_duration": 181,
"messages_count": 0,
"questions_count": 0,
"votes_count": 0,
"up_votes_count": 0
}
]
}
}Join our Livestorm Live Product Demo
During this 30-minute live event, we will introduce you to the platform. You will learn how to use Livestorm for your webinars and online meetings.