AttuneMail DocsTroubleshooting
Customer events

Connect Clerk events

Send untouched Clerk webhook payloads to AttuneMail for identity and lifecycle signals.

Updated 2026-08-235 minCreate a Clerk connection

Set up the endpoint

  1. 01

    Create a Clerk connection

    Copy the one-time native webhook URL shown by AttuneMail.

  2. 02

    Add a Clerk webhook endpoint

    Paste the URL and select only user or session events needed by your lifecycle program.

  3. 03

    Test with a non-production user

    Confirm the user ID, primary email, event name, and processing result in the event ledger.

Canonical mapping

Clerk event types become clerk.{event.type}. AttuneMail prefers the svix-id header, then a payload ID, then a stable payload hash for idempotency. User ID and primary email are extracted from data when present.

Journey design

  • Use user.created as an observed fact, not proof of marketing consent
  • Choose a separate activation goal such as onboarding.completed
  • Exit onboarding immediately when the customer reaches the goal
  • Use a stable product user ID across Clerk and your server-side product events