Webhooks Integration

A webhook is a URL to which you can send your data. It's a great way to capture any kind of data and send it to any destination you like.

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

What "Triggers" do you provide?

In total we provide 4 triggers:

  • New registrant
  • Webinar starts
  • Webinar ends (contains all registrants' data)
  • Webinar is published

After selecting your trigger, paste the URL you'd like to send your data to and click "Add a webhook":

Pro tip 👉 You can also test your webhooks and visualize the data that's sent out by using through this site:  https://webhook.site/

Here's the following JSON we send out for these 4 triggers:

New registrant:

{
  "attendee": {
    "identify": "af054bbf-20cb-47f0-8611-8bfe04f1f9fd",
    "created_at": "2018-11-19T14: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
  },
  "webinar": {
    "identify": "bd75c999-0ac5-4f3a-afe7-c47b2e264fcd",
    "title": "Webhooks webinar", // WEBINAR TITLE
    "slug": "webhooks-webinar",
    "created_at": "2018-11-19T14:20:51.047Z", // WEBINAR 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": "2018-11-19T14:22:29.192Z",
    "room_link": "https://app.livestorm.co/p/bd75c999-0ac5-4f3a-afe7-c47b2e264fcd/live?s=9b7900a8-df32-4804-9b63-63a817da7a5f", // WERBINAR ROOM LINK
    "estimated_started_at": "2018-11-19T17:00:00.000Z" // ESTIMATED STARTED AT
  }
}

Webinar starts:

{
  "webinar": {
    "identify": "bd75c999-0ac5-4f3a-afe7-c47b2e264fcd",
    "title": "Webhooks webinar", // WEBINAR TITLE
    "slug": "webhooks-webinar",
    "created_at": "2018-11-19T14:20:51.047Z", // WEBINAR 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": "2018-11-19T14:22:29.192Z",
    "published_at": "2018-11-19T14:22:29.192Z",
    "room_link": "https://app.livestorm.co/p/bd75c999-0ac5-4f3a-afe7-c47b2e264fcd/live?s=9b7900a8-df32-4804-9b63-63a817da7a5f", // WERBINAR ROOM LINK
    "estimated_started_at": "2018-11-19T17:00:00.000Z", // ESTIMATED STARTED AT
    "started_at": "2018-11-19T14:54:18.163Z" // STARTED AT
  }
}

Webinar ends:

{
  "webinar": {
    "identify": "980f5996-18fc-44e5-9d62-e9c6700ae7a6",
    "title": "Webhooks training",// WEBINAR TITLE
    "slug": "webhooks-training",
    "created_at": "2018-11-20T15:57:18.773Z", // WEBINAR CREATED AT
    "estimated_duration": 1800, // IN SECONDS
    "registration_link": "https://app.livestorm.co/p/980f5996-18fc-44e5-9d62-e9c6700ae7a6", // REGISTRATION PAGE LINK
    "published_at": "2018-11-20T15: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": "2018-11-20T18:00:00.000Z", // ESTIMATED STARTED AT
    "started_at": "2018-11-20T15:59:26.679Z", // STARTED AT
    "ended_at": "2018-11-20T16: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": "2018-11-20T15: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
      }
    ]
  }
}

Webinar is published:

{
  "webinar": {
    "identify": "2176cb84-8b1e-4441-80c3-99d002b849b0",
    "title": "Webhooks demo", // WEBINAR TITLE
    "slug": "webhooks-demo",
    "created_at": "2018-11-19T15:37:47.246Z", // WEBINAR CREATED AT
    "estimated_duration": 1800, // IN SECONDS
    "registration_link": "https://app.livestorm.co/p/2176cb84-8b1e-4441-80c3-99d002b849b0", // REGISTRATION PAGE LINK
    "published_at": "2018-11-19T15:38:08.665Z" // PUBLISHED AT
  }
}

👉 Unlike our other native integrations, the webhooks integration  will apply to all of your webinars. So you won't have to activate this integration for a webinar specifically. You can filter and choose which kind of data you'd like to keep through your own system once you receive the data.