Explore documentation

Create a Outgoing Webhook integration

Returns either a newly created Outgoing Webhook integration, or validation errors.

POST https://uptime.betterstack.com/api/v2/outgoing-webhooks

Headers

Authorization
required string
Content_Type
string

Body parameters

team_name
string
name
string
url
required string
trigger_type
required string
on_incident_started
boolean
on_incident_acknowledged
boolean
on_incident_resolved
boolean
custom_webhook_template_attributes
object
custom_webhook_template_attributes.http_method
string
custom_webhook_template_attributes.auth_username
string
custom_webhook_template_attributes.auth_password
string
custom_webhook_template_attributes.headers_template
array
custom_webhook_template_attributes.body_template
string|JSON
201

Response body

{
  "data": {
    "id": "16",
    "type": "outgoing_webhook",
    "attributes": {
      "name": "test",
      "url": "https://example.com",
      "trigger_type": "on_call_change",
      "team_name": "My team"
    },
    "relationships": {
      "custom_webhook_template": {
        "data": null
      }
    }
  },
  "included": [

  ]
}

Example cURL

Example
curl -X "POST" "https://uptime.betterstack.com/api/v2/outgoing-webhooks/" \
     -H "Authorization: Bearer $TOKEN" \
     -H 'Content-Type: application/json; charset=utf-8' \
     -d $'{
  "name": "Test",
  "url": "https://example.com",
  "trigger_type": "on_call_change"
}'