Webhooks push run results to your infrastructure without polling.

Create an endpoint

• Host an HTTPS endpoint that returns 200 OK within 10 seconds.
• Accept POST requests with Content-Type: application/json.
• Verify the X-Alg-Signature header against the signing secret you configure in the console.

Register in the console

1. Open https://app.algorythmos.fr/settings/webhooks.
2. Click New endpoint and provide the URL plus a description.
3. Choose events such as processor.run.completed, workflow.run.failed, or evaluation.completed.
4. Copy the signing secret and store it server-side.

Test delivery

curl -X POST https://api.algorythmos.fr/webhooks/test \
 -H "x-api-key: $ALG_KEY" \
 -H "Content-Type: application/json" \
 -d '{"event":"processor.run.completed","endpoint_id":"wh_123"}'

Monitor deliveries in the console; retries and payload history appear per endpoint.