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.

Livestorm comes with a native Webhooks integration, which allows you to send your registrant and event data to any URL of your choice.

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

1
Go to your Settings menu and then Account settings.
2
Click on Integrations and select the Webhooks card.
3
Click on Setup integration and then on Add a webhook.
4
Choose the trigger and copy the URL of your choice.
5
And click on Add a webhook.
6
You 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:

  1. Event created: when a new event is created
  2. Session created: when a session is scheduled
  3. Event is Published: when an event is published
  4. New registrant: when someone registers for an event session
  5. Event starts: when an event session starts
  6. 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
      }
    ]
  }
}
Did this answer your question? Thanks for the feedback There was a problem submitting your feedback. Please try again later.