Testing Webhook

Option A: Use Caret settings

To test your webhook integration:

A test event will be sent to your endpoint with type set to test.

For local development testing:

ngrok creates a secure tunnel to your local server:

# Start your local server on port 3000, then:
npx ngrok http 3000

Use the provided HTTPS URL as your webhook endpoint in Caret.

Webhook.site provides a temporary URL to inspect webhook requests without writing any code.

We recommend testing your webhook handler implementation with the following:

Signature Validation: Verify your endpoint correctly validates webhook signatures
Idempotency: Test handling of duplicate events with the same eventId
Error Handling: Ensure your endpoint returns appropriate status codes

Why isn’t my webhook receiving events?

Verify that your webhook URL is publicly accessible. Private or localhost URLs won’t receive events unless tunneled through a service like ngrok.

I’m getting signature validation errors.

Ensure you’re using the raw request body for validation, not a parsed JSON object. Any modification to the body will cause signature validation to fail.

What status code should my webhook endpoint return?

Your endpoint should return a 2xx status code (like 200 or 202) to indicate successful processing of the webhook event.
For detailed webhook logs, contact Caret support to get the logs.