What are System Events
System Events are built-in, pre-defined triggers that are tracked by Bread & Butter. They appear in your Dashboard whenever a user performs a standard action (such as viewing a page or logging in), and can be connected to automation integrations.
Conversion & Identity Events
Email Captured (API: identity_conversion) An email address is captured when a visitor enters a valid email address. This can happen while filling out a webform, an existing opt-in CRM form, or a 'Contact Us' form. This is the first step in identifying a visitor. If they later verify their identity (via social login or password), they will trigger the 'Profile Verified' event. This event is triggered only once per visitor.
Profile Verified (API: verified_conversion) A visitor profile is verified when they convert on the website using a high-trust method, such as a social login or email + password/PIN combination. This ensures the email address is genuine and belongs to the actual visitor. If these confirmations are not completed, the visitor remains in the 'Email Captured' state. This event is triggered only once per visitor.
Signed In (API: authentication) Triggered when a visitor with an existing Verified Profile signs in again. This usually happens when a user returns to the site after their session has expired and re-authenticates using a Bread & Butter tool (like a magic link or social login). Unlike conversion events, this can be triggered multiple times for the same visitor.
Auth Initiated (API: authentication_started) Triggered when a user clicks on one of the enabled social login buttons to initiate a Conversion or Sign-in event. This tracks the intent to sign in, even if the user does not complete the process.
Prompt Auth (API: blur_screen) Triggered when a user clicks a button that launches a Bread & Butter tool, such as the ‘Continue with’ prompt or a Content Gate. This indicates the user has engaged with a tool that requires authentication.
Invalid Email (API: invalid_email) Triggered when a user attempts to convert or sign in but provides an email address format that is rejected by the system.
Corrected Email (API: corrected_email) Triggered when a user, after initially entering an invalid email, successfully corrects it to a valid format during the same session.
Activity & Engagement Events
Form Submitted (API: form_submission) Triggered when a visitor successfully submits an existing form on your website, such as a newsletter signup, CRM opt-in, or registration form that Bread & Butter is monitoring.
Contact Us (API: contact_us) Triggered specifically when a user successfully submits the Bread & Butter 'Contact Us' tool.
Custom Data Updated (API: custom_data_updated) Triggered when a user converts or submits a form that contains custom fields (e.g., Company Name, Phone Number, Job Title), updating their profile with this new data.
Status & Maintenance Events
De-identification Requested (API: deidentification_requested) Triggered when a user formally requests to have their personal data removed (de-identified) from your system.
De-identified (API: deidentification) Triggered when a de-identification request is approved and processed, successfully removing the user's identifiable data.