Hi @thorny wigeon. I'm kapa.ai, your friendly support bot. I will try to answer your question by searching through the knowledge base. :wave:
#webhook issues
surreal domeBOT
It looks like you're encountering an error with your Clerk webhook integration with Convex. The error is related to Base64 padding issues when validating the webhook request.
This typically happens when there's an issue with the webhook signature verification process. The error occurs in the validateRequest function when creating a new Webhook instance from the svix library, which Clerk uses for webhook verification.
Here are some steps to troubleshoot this issue:
-
Check your webhook implementation: Make sure your webhook endpoint implementation follows the pattern shown in the Convex documentation. The error is occurring at the point where you're creating the Webhook instance to verify the signature.
-
Verify your CLERK_WEBHOOK_SECRET: Ensure that your Clerk webhook secret is correctly set in your Convex environment variables. The secret should start with
whsec_and should be copied exactly as shown in the Clerk dashboard. -
Check for any encoding issues: The error suggests there might be an issue with how the Base64 data is being handled. Make sure you're not modifying the headers or payload before passing them to the webhook verification function.
Here's a reference implementation from the Convex documentation that you can compare with your code:
async function validateRequest(req: Request): Promise<WebhookEvent | null> {
const payloadString = await req.text();
const svixHeaders = {
"svix-id": req.headers.get("svix-id")!,
"svix-timestamp": req.headers.get("svix-timestamp")!,
"svix-signature": req.headers.get("svix-signature")!,
};
const wh = new Webhook(process.env.CLERK_WEBHOOK_SECRET!);
try {
return wh.verify(payloadString, svixHeaders) as unknown as WebhookEvent;
} catch (error) {
console.error("Error verifying webhook event", error);
return null;
}
}
If you're still facing issues, you might want to check the Convex dashboard logs for more detailed information about the webhook requests and responses. You can also try enabling HTTP action debugging as mentioned in the Convex documentation.