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 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", // WEBINAR 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", // WEBINAR 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.

Did this answer your question? Thanks for the feedback There was a problem submitting your feedback. Please try again later.