Les articles d'aide existent en allemand et en anglais. Vous les lisez ici en anglais.
Installation
Can my system report conversions by webhook?
The endpoint POST /v1/webhooks/conversions is meant for systems that fire a webhook of their own rather than letting you program an API call. It always requires a valid signature.
When do I use the webhook instead of the Server Events API?
| Server Events API | Webhook | |
|---|---|---|
| Path | /v1/server/events | /v1/webhooks/conversions |
| Signature | optional | required |
| Several events per call | yes | yes |
| Typical trigger | your own backend code | an event in a third-party system |
The rules are the same: the same event schema, the same idempotency through the event ID, the same consent check. A shared identifier is needed here too, so the conversion lands in a journey.
Dernière vérification le 11 oct. 2026
Également demandé
- Set up a webhook
- Conversions by webhook
- Difference between webhook and API
Articles connexes
- How do I report conversions server-side?
How do I send events from my shop, CRM or backend?
Through POST /v1/server/events to the collector, with the server key in the authorization header. The portal shows the address and the ready-made call for your website under “Setup” on the “Server Events API” tab. The call is independent of the browser and therefore robust against ad blockers and short-lived cookies.
- How do I sign server-side requests?
How does the HMAC signature and replay protection work?
Send the header x-metrunio-signature with a timestamp and an HMAC-SHA256 over "<timestamp>.<raw body>", computed with the server key. The time window is five minutes and each signature is accepted exactly once.
- Can Metrunio notify my system?
How do I get new orders, refunds and alerts into my CRM by webhook?
By webhook, from Growth: under “Data connections → Webhooks” you enter an https address and choose the events. Metrunio calls it for every new order or lead, refund, alert and completed cost sync, signed. It carries no browser or customer identifier, but it does carry the order or lead identifier, value and time, and these can be personal data.