See llms.txt for all machine-readable content.

Back to Templates

Send a 7-email onboarding drip with Clerk webhooks and Brevo

Created by

Created by: Kishan Makani || makani-tech
Kishan Makani

Last update

Last update a day ago

Categories

Quick overview

This workflow receives signup, activation, and upgrade events via a webhook, then uses Brevo (Sendinblue) to manage contact attributes/lists and send a 7-email onboarding sequence for free users, stopping the sequence and moving contacts to a Pro list when they upgrade.

How it works

  1. Receives a POST webhook event (Clerk user.created or a backend { event, email, firstname, contactId } payload) on the your-product-onboarding path.
  2. Normalizes the incoming payload into a consistent event, email, and firstname structure and routes processing based on signup, activated, or upgrade_pro.
  3. On signup, upserts the contact in Brevo with onboarding attributes (for example PLAN=FREE and IS_ACTIVATED=false), adds the contact to Brevo list 6, and sends the Welcome email.
  4. After each wait period, re-fetches the contact from Brevo and exits the sequence if PLAN=PRO by removing them from list 6 and adding them to list 3.
  5. If the contact remains on the free plan, continues sending the remaining onboarding emails with delays between them, choosing different branches depending on the Brevo IS_ACTIVATED flag.
  6. On activated, updates the Brevo contact attribute IS_ACTIVATED=true so subsequent checks can fast-forward to the later part of the sequence.
  7. On upgrade_pro, updates the Brevo contact attribute PLAN=PRO and immediately moves the contact from list 6 to list 3 so any waiting executions stop at the next plan check.
  8. After the final email, removes the contact from list 6 and adds them to Brevo list 5 (Inactive) to mark the free onboarding sequence complete.

Setup

  1. Add a Brevo (Sendinblue) API credential and select it in all Brevo and HTTP Request nodes that call the Brevo v3 API.
  2. In Brevo, create or confirm the list IDs used by the workflow (6 = New Signup, 3 = Pro Users, 5 = Inactive) or update the list IDs in the Brevo API URLs.
  3. In Brevo, ensure your contact attributes exist (at least PLAN, IS_ACTIVATED, FIRSTNAME, PRODUCT_NAME, and CLERK_ID).
  4. Update the transactional email sender address/name and any links or branding in the HTML templates to match your product.
  5. Copy the production webhook URL for your-product-onboarding and configure it in Clerk (for user.created) and/or your backend event sender to POST the supported payload shape.