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¶
Parameter |
Description |
|---|---|
|
Must be |
|
Identifies the monitoring product. Must be one of the supported origins listed under Integrations below. |
|
Your Robusta account ID, found in |
|
Optional. The cluster to associate the alert with. When set, it overrides any cluster found in the alert payload and is used for the resulting alert investigation. When omitted, the cluster is taken from the payload if present, otherwise the alert is recorded under the |
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 emptyaccount_id,origin, ortype; invalidtypevalue.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.