Integrations
Sources
Clerk

Clerk source

Receive Clerk webhook events in Knock to trigger workflows and automate actions based on authentication and user management events.

The Clerk source enables you to receive Clerk webhook events directly in Knock. Clerk sends webhook callbacks when events occur in your application, such as a new user signing up, a session being created, or an organization being updated. Knock verifies each payload using your Clerk webhook signing secret, identifies the event type, and executes the actions you configure.

This integration is useful for building notifications around user lifecycle events: triggering welcome workflows when users sign up, notifying admins about organization changes, or syncing user data into Knock when profile details are updated.

Prerequisites

#
  • A Knock account with at least one environment configured.
  • A Clerk application with access to the Webhooks settings in the Clerk dashboard.

Getting started

#
1

Create the source in Knock

Navigate to Integrations > Sources in the Knock dashboard. Click "Create source" and select Clerk as the source type. Give it a name and description.

2

Copy the webhook URL

After creating the source, copy the webhook URL for the environment you want to configure.

3

Add the webhook endpoint in Clerk

In the Clerk dashboard, navigate to Webhooks and click "Add endpoint." Paste the Knock webhook URL and select the events you want Clerk to send.

4

Copy the signing secret into Knock

After creating the endpoint in Clerk, Clerk provides a signing secret. Copy this value and paste it into the Signing secret field in your Knock source environment configuration.

Once configured, Clerk sends webhook events to Knock in real time. You can verify that events are arriving by checking the event logs on the source environment page.

Pre-configured events

#

Clerk sends events for user, session, and organization lifecycle changes. Below are common events you might map to actions in Knock. You can enable or disable individual event types from the source environment configuration.

Event typeDescription
user.createdA new user signed up
user.updatedUser profile details were updated
user.deletedA user was deleted
session.createdA new session was created (user signed in)
session.endedA session ended (user signed out)
organization.createdA new organization was created
organization.updatedOrganization details were updated
organizationMembership.createdA user was added to an organization
organizationMembership.deletedA user was removed from an organization

See the Clerk webhook events documentation for the full list of available events.

Customization

#

You can modify the default action mappings or add new ones for any event type Knock receives from Clerk. For details on how field mapping works with dot-notation paths, see the HTTP source page.

If you need to map Clerk events to actions beyond triggering workflows, see the full list of available actions in the sources overview.

New chat