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, send a Slack notification after an event ends, send 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.

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 4 Triggers We Provide

We provide the following 4 triggers:

  1. New Registrant
  2. Event Starts
  3. Event Ends
  4. Event is Published

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 4 triggers:

New Registrant

{
  "attendee": {
    "identify": "af054bbf-20cb-47f0-8611-8bfe04f1f9fd",
    "created_at": "2021-02-05T14:30:17.070Z", // REGISTRATION DATE
    "first_name": "Jane", // REGISTRANT FIRST NAME
    "last_name": "Doe", // REGISTRANT LAST NAME
    "email": "jane_doe@livestorm.co", // REGISTRANT EMAIL
    "avatar_link": null,
    "referrer": "https://app.livestorm.co/",
    "utm_source": null,
    "utm_medium": null,
    "utm_term": null,
    "utm_content": null,
    "utm_campaign": null,
    "browser_version": "70",
    "browser_name": "Chrome",
    "os_name": "Macintosh",
    "os_version": "10.13.5",
    "screen_height": "1440",
    "screen_width": "2560",
    "ip_city": null,
    "ip_country_code": null,
    "ip_country_name": null,
    "password_key": "2948", // REGISTRANT ACCESS KEY
    "fields": {
      "company": "Livestorm", // CUSTOM FIELD (TEXT)
      "are_you_a_livestorm_user": "Yes" // CUSTOM FIELD (MULTIPLE CHOICE)
    },
    "connection_link": "https://app.livestorm.co/p/bd75c999-0ac5-4f3a-afe7-c47b2e264fcd/live?email=jane_doe%40livestorm.co&key=2948" // REGISTRANT ACCESS LINK
  },
  "event": {
    "identify": "bd75c999-0ac5-4f3a-afe7-c47b2e264fcd",
    "title": "Webhooks event", // EVENT TITLE
    "slug": "webhooks-event",
    "created_at": "2021-02-05T14:20:51.047Z", // EVENT CREATED AT
    "estimated_duration": 1800, // DURATION IN SECONDS
    "registration_link": "https://app.livestorm.co/p/bd75c999-0ac5-4f3a-afe7-c47b2e264fcd", // REGISTRATION PAGE LINK
    "published_at": "2021-02-05T14:22:29.192Z",
    "room_link": "https://app.livestorm.co/p/bd75c999-0ac5-4f3a-afe7-c47b2e264fcd/live?s=9b7900a8-df32-4804-9b63-63a817da7a5f", // EVENT ROOM LINK
    "estimated_started_at": "2021-02-05T17:00:00.000Z" // ESTIMATED STARTED AT
  }
}

Event Starts

{
  "event": {
    "identify": "bd75c999-0ac5-4f3a-afe7-c47b2e264fcd",
    "title": "Webhooks event", // EVENT TITLE
    "slug": "webhooks-event",
    "created_at": "2021-02-05T14:20:51.047Z", // EVENT CREATED AT
    "estimated_duration": 1800, // DURATION IN SECONDS
    "registration_link": "https://app.livestorm.co/p/bd75c999-0ac5-4f3a-afe7-c47b2e264fcd", // REGISTRATION PAGE LINK
    "published_at": "2021-02-05T14:22:29.192Z",
    "published_at": "2021-02-05T14:22:29.192Z",
    "room_link": "https://app.livestorm.co/p/bd75c999-0ac5-4f3a-afe7-c47b2e264fcd/live?s=9b7900a8-df32-4804-9b63-63a817da7a5f", // EVENT ROOM LINK
    "estimated_started_at": "2021-02-05T17:00:00.000Z", // ESTIMATED STARTED AT
    "started_at": "2021-02-05T14:54:18.163Z" // STARTED AT
  }
}

Event Ends

{
  "event": {
    "identify": "980f5996-18fc-44e5-9d62-e9c6700ae7a6",
    "title": "Webhooks training",// EVENT TITLE
    "slug": "webhooks-training",
    "created_at": "2021-02-05T15:57:18.773Z", // EVENT CREATED AT
    "estimated_duration": 1800, // IN SECONDS
    "registration_link": "https://app.livestorm.co/p/980f5996-18fc-44e5-9d62-e9c6700ae7a6", // REGISTRATION PAGE LINK
    "published_at": "2021-02-06T15:58:20.499Z",
    "room_link": "https://app.livestorm.co/p/980f5996-18fc-44e5-9d62-e9c6700ae7a6/live?s=2d1fbe8f-ef3b-485c-9156-0e0074309013", // WERBINAR ROOM LINK
    "estimated_started_at": "2021-02-06T18:00:00.000Z", // ESTIMATED STARTED AT
    "started_at": "2021-02-06T15:59:26.679Z", // STARTED AT
    "ended_at": "2021-02-06T16:09:27.244Z", // ENDED AT
    "duration": 601, // IN SECONDS
    "nb_registered": 2, // NUMBER OF REGISTRATIONS (INCLUDING HOST AND CONTRIBUTORS)
    "nb_attended": 2, // NUMBER OF ATTENDEES (INCLUDING HOST AND CONTRIBUTORS)
    "attendees": [
      {
        "identify": "169bff83-7a57-43cc-8e36-8720edfed86a",
        "created_at": "2021-02-06T15:58:44.040Z", // REGISTRATION DATE
        "first_name": "Jane", // REGISTRANT FIRST NAME
        "last_name": "Doe", // REGISTRANT LAST NAME
        "email": "elif.test.90@gmail.com", // REGISTRANT EMAIL
        "avatar_link": null,
        "referrer": "https://app.livestorm.co/",
        "utm_source": null,
        "utm_medium": null,
        "utm_term": null,
        "utm_content": null,
        "utm_campaign": null,
        "browser_version": "69",
        "browser_name": "Chrome",
        "os_name": "Macintosh",
        "os_version": "10.13.6",
        "screen_height": "800",
        "screen_width": "1280",
        "ip_city": "Paris",
        "ip_country_code": "FR",
        "ip_country_name": "France",
        "password_key": "7444", // REGISTRANT ACCESS KEY
        "fields": {
          "company": "Acme", // CUSTOM FIELD (TEXT)
          "are_you_a_livestorm_user": "No" // CUSTOM FIELD (MULTIPLE CHOICE)
        },
        "connection_link": "https://app.livestorm.co/p/980f5996-18fc-44e5-9d62-e9c6700ae7a6/live?email=elif.test.90%40gmail.com&key=7444", // REGISTRANT ACCESS LINK
        "is_attendance": true, // REGISTRANT ATTENDANCE
        "attendance_rate": 93, // ATTENDANCE RATE
        "attendance_duration": 562, // ATTENDANCE DURATION IN SECONDS
        "messages_count": 0, // NUMBER OF MESSAGES
        "questions_count": 0, // NUMBER OF QUESTIONS
        "votes_count": 0,  // NUMBER OF REPLIES TO POLLS
        "up_votes_count": 0 // NUMBER OF QUESTION UPVOTES
      }
    ]
  }
}

Event is Published

{
  "event": {
    "identify": "2176cb84-8b1e-4441-80c3-99d002b849b0",
    "title": "Webhooks demo", // EVENT TITLE
    "slug": "webhooks-demo",
    "created_at": "2021-02-05T15:37:47.246Z", // EVENT CREATED AT
    "estimated_duration": 1800, // IN SECONDS
    "registration_link": "https://app.livestorm.co/p/2176cb84-8b1e-4441-80c3-99d002b849b0", // REGISTRATION PAGE LINK
    "published_at": "2021-02-05T15:38:08.665Z" // PUBLISHED AT
  }
}
Did this answer your question? Thanks for the feedback There was a problem submitting your feedback. Please try again later.