Add the endpoint
Add your URL
In your dashboard, under Compliance export, add an HTTPS URL. Klariqo generates a signing secret for that endpoint. Copy the secret now, it is shown only once.
Verify the endpoint
Klariqo sends a verification request carrying a challenge. Your endpoint must echo the challenge back, either in the response body or in a response header. This proves you control the URL.
Requirements
- HTTPS only, on a public URL that Klariqo can reach.
- Respond with a 2xx quickly. Acknowledge first, then do any heavy processing.
- Keep the signing secret safe. You need it to verify every delivery.
Rotating the secret
You can rotate the signing secret. During a rotation, the previous secret stays valid for a short window and deliveries are signed with both the old and the new secret, so you can update your endpoint within the window without missing a record.Verify signatures
Confirm a delivery genuinely came from Klariqo.
Record envelope
The shape of the event you receive.