Our Clerk integration lets you:
  • Create and update contacts
  • Send events to trigger loops
Our Clerk integration is built on top of our Incoming webhooks feature. This system lets you send webhooks from supported platforms directly to Loops so you can easily sync users and customers as well as send automated emails. Please read our guide about incoming webhooks With Clerk, you can keep your user data synced to Loops so you can send emails to your userbase.

​
Supported events

We accept the following events:
  • user.created
  • user.deleted
  • user.updated
  • waitlistEntry.created
  • waitlistEntry.updated
Clerk webhook docs If you send other events, they will be ignored.
If you would like to see more events supported, please let us know by sending an email to [email protected]. Please keep in mind only events that contain an email address are able to be processed.

​
Synced data

For user.created or user.updated events, we sync the following Clerk data to your Loops contacts:
  • User ID
  • Email address
  • First name (optional)
  • Last name (optional)
We use the IDs of Clerk users to match contacts in your Loops audience. If the user ID is not found in Loops, we will create a new contact. The user.deleted event can be used to delete or unsubscribe your Clerk users from your Loops audience. For waitlistEntry.* events, we sync:
  • Email address
There is no user ID available for waitlist events. When a user graduates from your waitlist to being a user (i.e. you accept them and they complete their account), their user ID will be added to your contact in Loops.

​
Create a webhook endpoint in Loops

Follow the instructions here to create a new webhook endpoint, which will allow you to send webhook events directly to Loops. Endpoint form

​
Create a webhook in Clerk

Next, you need to set up webhooks in Clerk. Inside a project in Clerk, go to Configure -> Webhooks and click + Add Endpoint. Paste in the endpoint URL from Loops, then select the event(s) you want to send (see our supported events above). Adding a webhook in Clerk Click Create to finish. The last step is to copy the signing secret into Loops. On the webhook page in Clerk, click the eye icon on the right to show the secret in the page. Copy the secret and paste it into the Signing Secret field in Loops. Reveal Clerk secret Now you’re all set up.

​
Testing Clerk webhooks

Clerk offers a nice way to test webhooks. Click through to the webhook you created and then the Testing tab. Select user.created or user.updated from the Send event dropdown, tweak the example data that’s shown, then click Send Example. This will send real data to your Loops account. You can also test your webhook by creating and editing users in the Users page in Clerk, or by signing up in your application. You can see all sent webhooks by going to Webhooks, clicking on the webhook and scrolling down to the Message Attempts section. On Loops’ end, you will see new contacts appear in your Audience page, and triggered events in the Events page.

​
Examples

Here are some examples of how you can send data from Stripe to Loops to sync contacts and trigger useful emails to your customers.

​
Syncing users to Loops

Create or update contacts in your Loops audience when a user is created or updated in Clerk.
  1. Create a new Clerk webhook endpoint in Loops (instructions).
  2. In Clerk, create a new webhook (instructions above) for the user.created and user.updated events and paste in your endpoint’s URL.
  3. In Loops, make sure user.created and user.updated are toggled on on the Clerk settings page.

​
Syncing waitlist signups to Loops

Create or update contacts in your Loops audience when someone joins your waitlist in Clerk.
  1. Create a new Clerk webhook endpoint in Loops (instructions).
  2. In Clerk, create a new webhook (instructions above) for the waitlistEntry.created event and paste in your endpoint’s URL.
  3. In Loops, make sure waitlistEntry.created is toggled on on the Clerk settings page.
  4. To keep track of waitlist users you can use the Assign a user group option. Enter something like “Waitlist” into field.

​
Send an email to all new Clerk users

Send an email from Loops when a new user is created in Clerk.
  1. Create a new loop in Loops using our Onboarding drip template.
  2. For the loop trigger, select Event received and enter newClerkUser (or something similar).
  3. Set up your Clerk webhook endpoint in Loops (instructions).
  4. In Clerk, create a new webhook (instructions above) for the user.created event and paste in your endpoint’s URL.
  5. In Loops, make sure user.created is toggled on, and select the event name you chose in Step 2 from the Trigger an event field.

​
Enter all new Clerk users into an onboarding email sequence

Send an email from Loops when a new customer is created in Clerk.
  1. Complete Steps 1–5 from “Send an email to all new Clerk users” above.
  2. Add more emails and timers into the loop to complete your email sequence.

​
Send an email to a deleted Clerk user

Send an email from Loops when a user is deleted in Clerk.
  1. Create a new loop in Loops.
  2. For the loop trigger, select Event received and enter deletedClerkUser (or something similar).
  3. Set up your Clerk webhook endpoint in Loops (instructions).
  4. In Clerk, create a new webhook (instructions above) for the user.deleted event and paste in your endpoint’s URL.
  5. In Loops, make sure user.deleted is toggled on, and select the event name you chose in Step 2 from the Trigger an event field.
  6. You can optionally delete or unsubscribe the user from your audience from the same settings. Note that both options will stop that contact from receiving future emails from Loops.