Generic webhook payload

Request

POST https://ingress.aciona.me/webhooks/<alertSourceId>
Content-Type: application/json
X-Aciona-Token: <sourceToken>

The body is a JSON object representing a single alert.

Fields

string

Incident title. When absent, aciona.me uses Untitled alert.

string

Detail of the problem. Shown in the incident body and in notifications.

string

default:"warning"

Alert severity. Accepts the canonical values critical, high, warning and info, plus common synonyms (p1, sev2, error, warn, low…). Unrecognized values fall back to warning.

string

Name of the affected service as registered in aciona.me. Also accepted as labels.service. Determines the responsible team and therefore who gets paged.

string

Stable identifier of the problem at the source. This is the correlation key used to aggregate repeated triggers into the same incident.

string

default:"firing"

Accepts firing or alerting. Any other value makes the alert accepted and discarded, with no incident created. When absent, it is treated as firing.

object

Free-form labels, preserved on the incident. Useful for context (env, region, cluster, job).

string

Link back to the alert’s origin. Also accepted as externalUrl.

Full example

{
  "externalId": "checkout-error-rate",
  "title": "Checkout error rate above 5%",
  "description": "5xx errors on 7.2% of requests over the last 5 minutes",
  "severity": "critical",
  "service": "checkout",
  "status": "firing",
  "labels": {
    "env": "prod",
    "region": "sa-east-1",
    "cluster": "prod-a"
  },
  "url": "https://observability.example.com/d/checkout"
}

Minimal example

{
  "title": "Nightly job failed",
  "service": "data-pipeline"
}

Response

{ "status": "accepted" }

With HTTP 202. Processing is asynchronous: the incident shows up in the dashboard within seconds.

Limitations

Generic sources do not support auto-resolution. Sending "status": "resolved" discards the alert; it does not resolve the incident. For auto-resolution, use your tool’s dedicated source type.

One POST represents one alert. For multiple alerts, send multiple POSTs.
The body has a size limit (1 MB by default).

Reference

Generic webhook payload

Request

Fields

Full example

Minimal example

Response

Limitations

Generic webhook guide

​Request

​Fields

​Full example

​Minimal example

​Response

​Limitations

Generic webhook guide

Request

Fields

Full example

Minimal example

Response

Limitations