Send alerts directly to Doctor Droid from your monitoring systems via webhook integration.

🔗 Webhook Endpoint

URL: https://playbooks.drdroid.io/alert-middleware/webhooks/alert/ingest Method: POST Content-Type: application/json

🔐 Authentication

Use Bearer token authentication. Get your API token from the API Keys section in app.drdroid.io. API Keys Section Header: Authorization: Bearer <your-api-token>

📝 Request Format

Required Fields

FieldTypeDescription
alert_titlestringConcise description of the alert
alert_messagestringDetailed message or description
severitystringcritical, warning, info
timestampstringISO 8601 timestamp (e.g., "2024-01-15T10:30:00Z")

Optional Fields

FieldTypeDescription
sourcestringSource system (e.g., "datadog", "sentry")
tagsobjectKey-value pairs for categorization
metadataobjectAdditional context or data

📋 Example Request

curl -X POST "https://playbooks.drdroid.io/alert-middleware/webhooks/alert/ingest" \
  -H "Authorization: Bearer <your-api-token>" \
  -H "Content-Type: application/json" \
  -d '{
    "alert_title": "Datadog Connection Failed",
    "alert_message": "Unable to connect to Datadog",
    "severity": "critical",
    "timestamp": "2024-01-15T10:30:00Z"
  }'

🔧 Platform Integrations

NewRelic Setup

  1. Go to Alerts > Destinations in the left sidebar
  2. Click Add a webhook destination
  3. Enter the webhook URL: https://playbooks.drdroid.io/alert-middleware/webhooks/alert/ingest
  4. Set Authentication Type to Bearer Token
  5. Enter your API token
  6. Add this destination to your alert policies alongside existing alerting systems
Coralogix:
  1. Click on the Data Flow dropdown in the top menu bar
  2. Select Outbound Webhooks
  3. Create a generic webhook with POST method
  4. In the editing message section, add the authorization token as shown below:
Coralogix Webhook Configuration Grafana:
  1. In the left menu bar, go to Alerting > Contact Points
  2. Click Create Contact Point
  3. Add webhook with configuration similar to the screenshot below
  4. It is mandatory to set the optional webhook settings in Grafana as shown in the screenshot
  5. Save the contact point
Grafana Webhook Configuration Sentry:
  1. Go to Settings > Integrations
  2. Click Create New Integration of type Webhook
  3. Set method type as POST
  4. Set authentication method as Bearer Token
Datadog:
  1. Go to Integrations > Webhooks
  2. Click New Webhook
  3. Configure the custom header to include the authorization bearer token as shown below:
Datadog Webhook Configuration Other platforms support Bearer token authentication natively:
  • Elasticsearch - Configure webhook with Bearer token authentication

📊 Response Codes

Status CodeDescription
200Alert successfully ingested
400Bad request - invalid payload format
401Unauthorized - invalid or missing API token
429Rate limit exceeded
500Internal server error