Send Events API¶

Send alerts from your monitoring system to Robusta through a single webhook endpoint.

This is the recommended ingestion path for new integrations. The legacy Send Alerts API remains available for existing customers.

Endpoint¶

POST https://api.robusta.dev/webhooks?type=alert&origin=<ORIGIN>&account_id=<ACCOUNT_ID>

Query Parameters¶

Authentication¶

Send your Robusta API key as a Bearer token. Generate keys in the Robusta UI under Settings → API Keys → New API Key.

Authorization: Bearer <API_KEY>

The key must be scoped to the account_id query parameter. Mismatches return 401.

Example Request¶

curl --location --request POST \
  'https://api.robusta.dev/webhooks?type=alert&origin=datadog&account_id=ACCOUNT_ID' \
  --header 'Authorization: Bearer API_KEY' \
  --header 'Content-Type: application/json' \
  --data-raw '{ "title": "High error rate", "severity": "high" }'

Response¶

A successful request returns 200 with the ID of the stored event:

{ "id": "8f1b...e21" }

Errors:

• 400 — missing or empty account_id, origin, or type; invalid type value.

• 401 — invalid or out-of-scope API key.

• 429 — rate limit exceeded (300 requests per 5-minute window per account).

• 503 — transient storage failure; vendors should retry.

Integrations¶

Pick your monitoring system below for step-by-step instructions. Each page provides the URL to paste into your vendor's webhook configuration along with the API key.

Prometheus & AlertManager¶

APM & Observability¶

Cloud Provider Monitoring¶

Incident Management¶

Other¶