Skip to main content
ZStack
Alerting & Response/Alert Channels & Integrations

ReceiveAlertmanagerWebhook

Receive alert notifications from Alertmanager webhook callbacks Auth: X-Webhook-Secret header (static secret, forwarded as gRPC metadata).

POST/api/v1/alerting/webhook/{receiver}

Operation ID

ReceiveAlertmanagerWebhook

Since

1.0.0

Execution Mode

Synchronous

Auth Context

Auth Required

Auth Context

Send these values as request headers when calling this API.

AuthorizationstringRequired

Bearer Token

X-Tenant-IDstring

X-Tenant-ID

Request Inputs

application/json

Path Parameters

  • receiver
    StringRequired

    Receiver name from Alertmanager configuration

Body Fields

  • version
    StringRequired

    Alertmanager API version

    Example: 4

  • groupKey
    StringRequired

    Group key identifying the alert group

    Example: {}:{alertname=HighCPU}

  • truncatedAlerts
    IntegerRequired

    Number of alerts truncated from the payload

    Example: 20

  • status
    StringRequired

    Group status: firing or resolved

    Example: firing

  • externalUrl
    StringRequired

    External URL of the Alertmanager instance

    Example: http://alertmanager:9093

Responses

200 OK
200 OK

On success, this API returns the following response structure.

  • received
    Integer

    Number of alerts received in the payload

    Example: 5

  • created
    Integer

    Number of new alerts created

    Example: 3

  • updated
    Integer

    Number of existing alerts updated

    Example: 1

  • skipped
    Integer

    Number of duplicate alerts skipped

    Example: 1

  • injected
    Integer

    Number of alerts injected into the pipeline

    Example: 4

  • fallback
    Boolean

    Whether fallback processing was used

    Example: false

  • fallbackReason
    String

    Reason for fallback if applicable

    Example: primary channel unavailable

Change History

View all change history

  • Change Time

    AddedRequest body fields generatorURLDeletedRequest body fields generatorUrl
    View API