Webhooks

Webhooks automatically send notifications to external systems when certain events occur in arkmetis – for example, when a crawl completes or an alert triggers.

Setting Up a Webhook

1. Open Settings → Webhooks in your project
2. Click "Create Webhook"
3. Enter the URL where events should be sent
4. Select the Events you want to subscribe to:
   • crawl_completed – Crawl finished
   • alert_triggered – Alert triggered
   • Additional events depending on enabled services
5. Click "Save"

After creation, a Webhook Secret is displayed (40 characters). Save it securely – it's only shown once. Use the secret to verify the authenticity of incoming webhooks.

Testing a Webhook

Click "Send Test" next to a webhook. arkmetis sends a test event to the configured URL so you can verify the integration.

Managing Webhooks

• Enable/Disable – Toggle the webhook on or off without deleting it
• Change URL – Update the target URL
• Change Events – Adjust the subscribed events
• Delete – Removes the webhook and its entire delivery history

Delivery History

For each webhook you can see the last 50 delivery attempts:

• Timestamp – When was it sent?
• Event type – Which event?
• Status – Successful or failed?
• Response – The recipient's response

Error handling: Repeated failures increment a failure counter. When you re-enable a webhook, the counter is reset.

Cost

Webhooks are free and included in the team plan features.