Headers
Bearer $TOKEN
application/json
Body parameters
Required if using global API token to specify the team which should own the resource.
The name of the Outgoing Webhook integration that you can see in the dashboard.
The URL of the Outgoing Webhook integration.
The type of trigger for the Outgoing Webhook integration. Possible values are on_call_change
, incident_change
and monitor_change
.
Whether to trigger the Outgoing Webhook integration when an incident starts. Only applicable if trigger_type
is incident_change
.
Whether to trigger the Outgoing Webhook integration when an incident is acknowledged. Only applicable if trigger_type
is incident_change
.
Whether to trigger the Outgoing Webhook integration when an incident is resolved. Only applicable if trigger_type
is incident_change
.
Use this to specify the custom webhook template attributes. See below.
The HTTP method to use when sending the webhook. Possible values are get
, post
, put
, patch
and head
.
The username to use for basic authentication.
The password to use for basic authentication.
The headers to send with the webhook.
{
"custom_webhook_template_attributes": {
"headers_template": [
{ "name": "Content-Type", "value": "application/json" },
{ "name": "X-Custom-Header", "value": "Custom-Value" }
]
}
}
The body to send with the webhook. The value can be a stringified JSON or a JSON object.
{
"custom_webhook_template_attributes": {
"body_template": {
"data": {
"id": "$INCIDENT_ID",
"type": "incident",
"attributes": {
"name": "$NAME",
"url": "$URL",
"http_method": "$HTTP_METHOD",
"screenshot_url": "$SCREENSHOT_URL"
}
}
}
}
}
{
"custom_webhook_template_attributes": {
"body_template": "{\"data\":{\"id\":\"$INCIDENT_ID\",\"type\":\"incident\",\"attributes\":{\"name\":\"$NAME\",\"url\":\"$URL\",\"http_method\":\"$HTTP_METHOD\",\"screenshot_url\":\"$SCREENSHOT_URL\"}}}"
}
}
When not specified, the default template is used. Each trigger_type
has its own default template:
{
"data":{
"message": "$MESSAGE",
"emails": $EMAILS_JSON_ARRAY,
"calendar_id": $ON_CALL_CALENDAR_ID,
"calendar_name": "$ON_CALL_CALENDAR_NAME",
"primary_calendar": $DEFAULT_ON_CALL_CALENDAR
}
}
{
"data": {
"id": "$INCIDENT_ID",
"type": "incident",
"attributes": {
"name": "$NAME",
"url": "$URL",
"http_method": "$HTTP_METHOD",
"cause": "$CAUSE",
"started_at": "$STARTED_AT",
"acknowledged_at": "$ACKNOWLEDGED_AT",
"resolved_at": "$RESOLVED_AT",
"response_content": "$RESPONSE_CONTENT",
"response_url": "$RESPONSE_URL",
"screenshot_url": "$SCREENSHOT_URL"
}
}
}
{
"data":{
"id": "$MONITOR_ID",
"type": "monitor",
"attributes":{
"url": "$URL",
"pronounceable_name": "$PRONOUNCEABLE_NAME",
"monitor_type": "$MONITOR_TYPE",
"required_keyword": "$REQUIRED_KEYWORD",
"verify_ssl": $VERIFY_SSL,
"check_frequency": $CHECK_FREQUENCY,
"call": $CALL,
"sms": $SMS,
"email": $EMAIL,
"team_wait": "$TEAM_WAIT",
"http_method": "$HTTP_METHOD",
"request_timeout": "$REQUEST_TIMEOUT",
"recovery_period": "$RECOVERY_PERIOD",
"request_body": "$REQUEST_BODY",
"paused_at": "$PAUSED_AT",
"last_checked_at": "$LAST_CHECKED_AT"
}
}
}