Sources in Knock

Sources connect external services to Knock so that events from those services can drive actions such as triggering workflows, identifying users, and managing objects and tenants.

Knock supports three categories of source integrations:

• Incoming webhooks. Receive events from services like Stripe, Clerk, and WorkOS. Pre-built templates handle payload verification and provide default action mappings, or create a custom source for any webhook provider.

• CDP integrations. Forward track and identify events from platforms like Segment and RudderStack to trigger workflows and keep recipient data in sync.

• Reverse ETL integrations. Sync warehouse data from platforms like Hightouch and Census to keep users, objects, and tenants up to date.

• Census
• Clerk
• Custom source
• Freshpaint
• Hightouch
• Jitsu
• Polytomic
• PostHog
• RudderStack
• Segment
• Stripe
• Supabase
• WorkOS

If you want us to add a new source to this list, please let us know at support@knock.app.

You can configure sources from the Platform > Sources page in your Knock dashboard. Initial creation of a source is managed at the account level of your Knock account, though you configure specific events and their actions within your Knock environments.

Each source has a unique configuration for every Knock environment in your account. This makes it possible to connect your development source environment to your Knock development environment. Use the environment dropdown in the top header to switch between environments and view their configurations.

When a source event is received, you can configure Knock to execute any of the following actions:

Action	Description
Trigger workflow	Start a workflow run for one or more recipients
Cancel workflow	Cancel an in-progress workflow run
Identify user	Create or update a user in Knock
Subscribe user	Add a user to an object's subscribers list
Unsubscribe user	Remove a user from an object's subscribers list
Set object	Create or update an object
Delete object	Remove an object
Set tenant	Create or update a tenant
Delete tenant	Remove a tenant
Add audience member	Add a member to an audience
Remove audience member	Remove a member from an audience

After events start flowing into Knock you can configure mappings that tell Knock which action to run and how to populate its parameters. Mappings use dot-notation paths to extract values from the incoming payload and map them to the fields required by each action.

For example, a Stripe invoice.paid event includes nested data about the invoice and customer:

You could map data.object.customer to the recipients field and data.object to the data field when triggering a workflow, giving your templates access to the invoice amount, currency, and subscription details.

For full details on configuring custom event types and field mappings, see the custom source page.

In some cases, you may need to debug source event connections to ensure your integration is sending the correct payloads to Knock.

Event logs show the contents of each event sent into Knock.

Action logs describe what (if any) action Knock took after receiving an event. Action logs are a helpful starting point when troubleshooting workflows or auditing actions Knock has taken for any given event.

By default, Knock processes every valid event received from your source. You can enable idempotency checks to deduplicate events that have already been received and processed. This is useful if you know your source may send duplicate events.

Idempotency configuration varies by source type. For pre-built webhook integrations, Knock auto-configures the idempotency key. For CDP sources and custom webhooks, you may need to enable idempotency and verify the key field. See your individual source page for setup details.

Your idempotency keys must be valid strings no more than 255 characters in length. If an invalid key is found, Knock still ingests your source event but will not attempt to execute your event idempotently. In addition, Knock drops the invalid idempotency key and you will not see it appear in your event logs.

When Knock executes a source event with an idempotency key, it first checks whether a preceding execution should be replayed. Knock finds a preceding execution if it is recorded within the idempotency window with the same:

• Idempotency key value
• Event type
• Integration source configuration
• Knock environment in your account

If no preceding execution is found, Knock executes your event normally and records that execution for future replay by the same idempotency key. However, if Knock fails to execute your source event, it will not record the execution. Knock only records successful event executions for idempotent replay.

If Knock replays an event via an idempotency check, you will still see an event log for that execution. However, the log will not have any actions associated and Knock will label it as idempotent.