Summary

New customers are asking for additional integrations to their related systems. Suggesting we implement outbound webhooks for the common platform related events that would allow them to use code or no-code tools (E.g. Zapier, Integromat, etc) to build automations.

Operational and scaling benefit is that it would allow us to avoid custom one-off integrations with certain platforms.

Alternatively we could explore making our API documentation available and build an accessible API allowing external teams to integrate to Gradual, but based on current customers, the webhook would be more applicable to more customers.

Outbound Webhook Events

• New User Is Created - A new user completes the sign-up form (user does not have to log in and begin a session)
  • Payload Fields:

    • Webhook-specific Fields

      Field Name	Content	Type
      type	newUserIsCreated	string
      dateOfSignUp	Sign Up Date Time	string

    • User Info Fields

      Field Name	Content	Type
      userId	User ID	string
      userEmail	Email	string
      userFirstName	First Name	string
      userLastName	Last Name	string
      userCompany	Company Name	string
      userTitle	Job Title	string
      userLinkedIn	LinkedIn URL	string
      userAvatarUrl	Avatar URL	string
      userLocation	Location	string
      memberType	Membership Type	string
      approvalStatus	Approved / Pending	string

    • Tracking Data fields

      Field Name	Content	Type
      utmSource	UTM Source	string
      utmMedium	UTM Medium	string
      utmCampaign	UTM Campaign	string
      utmContent	UTM Content	string
      utmTerm	UTM Term	string
      referUrl	Referrer URL	string

• User Registers for Event (Completed when logged-in user successfully registers for an event)
  • Payload Fields:

    • Webhook-specific Fields

      Field Name	Content	Type
      type	userRegistersForEvent	string
      dateOfRegistration	Registration Date Time	string
      eventQuestions	User Answers to Event Questions	object
      (dynamic based on event setup)

    • Event Info Fields

      Field Name	Content	Type
      eventName	Event Name	string
      eventslug	Event Slug	string
      eventUrl	Event Gradual URL	string

    • Referral Data Fields

      Field Name	Content	Type
      referringCode	Referring Code	string
      referringUserId	Referring User ID	string
      referringUserEmail	Referring User Email	string
      referringUserFirstName	Referring User First Name	string
      referringUserLastName	Referring User Last Name	string
      referringUserTitle	Referring User Job Title	string
      referringUserCompany	Referring User Company	string

• User Cancels Event Registration (When a user cancels their event registration
  • Payload

    • Webhook-specific Fields:

      Field Name	Content	Type
      type	userCancelsEventRegistration	string
      dateOfCancellation	Cancellation Date Time	string

• User Completes Onboarding