Troubleshooting / FAQ
Common problems, and where in the docs to go for the full explanation.
My pipeline isn't processing events
Check the source connector's health field via the Connectors endpoint. A down connector stalls every pipeline that reads from it. If it's healthy, confirm the pipeline itself is active and not paused — see Scheduling & triggers.
Events keep failing and landing in the dead-letter queue
Walk through Handling errors & retries — it covers both diagnosing the failure and replaying events once fixed.
I'm not receiving webhook deliveries
Verify your endpoint returns a 2xx status and that you're checking X-KMP-Signature correctly — a rejected signature looks identical to a dropped delivery from the outside. Full details in the Webhooks endpoint reference.
I'm getting 429s
You've hit the standard-tier limit described in Rate limits. Back off using the Retry-After header.
A number of "it worked yesterday" reports trace back to v1's offset pagination or polling patterns carried over into v2 code. See the Migration guide.
Still stuck?
Reach the team via Support / Contact.