Webhooks
Madeleine avatar
Written by Madeleine
Updated over a week ago

Webhooks help you integrate Maven into other tooling you might use for your course.

For example, you might have an email service provider (ESP) you use to email students. In this case, you can send data from Maven, directly to your ESP, or send it to Google Sheets, and then to your ESP.

Data you can capture via webhooks:

  • <waitlist.joined> email address of a student who has joined the waitlist

  • <application.started> email address of a student who has started filling out an application

  • <application.received> email address of a student who has completed filling out an application

  • <application.accepted> email address of a student who you accept

  • <payment.initiated> email address of a student who has started the payment flow

  • <payment.abandoned> email address of a student who has dropped off after starting the payment flow (abandoned cart)

  • <payment.success> email address of a student who has paid along with the amount they have paid

  • <user_cohort.maybe> email address of a student who has been marked as 'maybe' by you or your team in a specific cohort

  • <user_cohort.enrolled> email address of a student who has been completed enrolling in your cohort. Note that this event is often sent at the same time, for the same user, as the <payment.success> event, except when you "Enroll for Free", in which case only this event is sent

  • <user_cohort.removed> email address of a student who has been removed from a specific cohort by you or your team.

Ultimately, webhooks give you options.

To set up webhooks for your course, we recommend you use Zapier. It's an easy-to-use platform to connect different apps and websites. In this example, we'll send data from Maven, to a Google sheet.

What you need

  • Maven Admin access

  • Zapier account (set this up for free at Zapier.com)

  • Google sheet that you'll send the data. Add the following headers in row 1:

    • Event

    • Course

    • Cohort

    • User

    • Email

    • Querystring


Steps

  1. Create a new Zap and find the Webooks by Zapier trigger.

  2. In the Trigger Event drop-down, select Catch Hook

  3. Copy the Custom Webhook URL

  4. In your Maven course settings, paste the Custom Webhook URL into the field Webhook Endpoint.

  5. Time to test. Wait 2 minutes after you've added your Webhook to Maven. After the two minutes, apply as a student would. In Maven, you should see something like this:

  6. In the second half of setting up your Zapier web hook, you'll select an Action. In this case, writing data to Google Sheets. Follow the prompts and Create a Spreadsheet Row.

  7. Follow the prompts and Create a Spreadsheet Row.

  8. After integrating your Google account, find the Google Sheet you're going to send the data too. You'll also have to select the Sheet too.

  9. Match the Webhook data to your Google Sheet headings. This is essentially telling Zapier which column it should put each datapoint. Finally, turn on your integration.

  10. Run another test:

    1. Apply as a student

    2. Check your Google Sheet that a new row has been created with application.received.

    3. In the Admin, Accept the test student.

    4. Check your Google Sheet that a new row has been created with application.accepted.

Congratulations πŸŽ‰ You've set up your webhook.

Did this answer your question?