Webhooks

Webhooks

Outgoing webhooks

Metrikia can send HTTP notifications when certain events occur:

Setup

1. Settings > Integrations > Webhooks
2. Click + New webhook
3. Enter the destination URL
4. Select the events to listen to
5. Add a secret for HMAC validation (optional but recommended)

Security

Each webhook request includes:

• X-Webhook-Signature header: HMAC-SHA256 signature of the body
• X-Webhook-Event header: Event type
• X-Webhook-Timestamp header: Timestamp of the request

Validate the signature server-side to ensure the request comes from Metrikia.

Retries

On failure (HTTP status != 2xx), Metrikia retries:

• 1st attempt: immediate
• 2nd attempt: after 1 minute
• 3rd attempt: after 5 minutes
• Abandoned after 3 failures

Incoming webhooks

You can also send data to Metrikia via the REST API. Refer to the API documentation for available endpoints.