RooQuiz Docs
Connectors & Automation

Trigger Events & Scope

Each connector decides when it fires (events) and which quizzes may fire it (scope). The two are ANDed: the event must match and the source quiz must be in scope before anything is delivered.

Trigger events

Every connector needs at least one event:

EventFires when
New submissionSomeone completes a quiz — every submission, including anonymous ones and repeat attempts by the same person
New leadSomeone leaves their contact details with your team for the first time
Booking createdA call booked from a result page stands. If the Cal.com event type requires confirmation, that is the moment you confirm it in Cal.com
Booking cancelledEither side cancels the call in Cal.com
Booking rescheduledThe call moves to a different time in Cal.com

"New lead" fires once, the first time that person leaves their details. The same person taking another quiz later does not fire it again, because leads are deduplicated across quizzes. If you want a notification on every submission, choose New submission instead.

New submission is sent once the result has been calculated, so the delivery always carries the score, level or result type.

Booking events only cover sessions that actually stand. A pending request, a declined request, or a pending request that is rescheduled or withdrawn fires nothing — downstream automations shouldn't act on a meeting that hasn't been agreed. Booking events also need the Cal.com connector; without it RooQuiz never hears about bookings.

Trigger scope

Scope controls which quizzes may fire this connector:

  • All quizzes — the default. Any event from any quiz in the team is delivered.
  • Specific quizzes — only the quizzes you select fire it.

Scope is matched against the quiz the event came from. For "New submission", that's the quiz that was just submitted; for "New lead", that's the quiz where the person first left their details — not the most recent one they took.

A typical use: push your flagship lead-gen quiz to Slack so the team sees it instantly, and keep an internal quiz from bothering anyone.

Combinations worth copying

What you wantEventsScope
Everyone hears about a new clientNew leadAll quizzes
Score every response in your own backendNew submissionAll quizzes
Only track the flagship quizNew leadSpecific quizzes
Get told when your calendar shiftsBooking cancelled + rescheduledAll quizzes
Sync leads into your ESPNew leadAll quizzes

Changing events or scope only affects events from then on — nothing is replayed.

On this page