Create an incoming webhook

Returns either a newly created incoming webhook, or validation errors.

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

Headers

Authorization
required string
Content_Type
string

Body parameters

name
string
*
201

Response body

{
  "data": {
    "id": "5",
    "type": "incoming_webhook",
    "attributes": {
      "name": "Test",
      "created_at": "2023-01-25T13:00:18.980Z",
      "updated_at": "2023-01-25T13:00:18.980Z",
      "policy_id": null,
      "url": "https://uptime.betterstack.com/api/v1/incoming-webhook/[token]",
      "sample_query_string": null,
      "sample_headers": null,
      "sample_body": null,
      "call": false,
      "sms": false,
      "email": true,
      "push": true,
      "team_wait": null,
      "recovery_period": 180,
      "paused": false,
      "started_rule_type": "unused",
      "acknowledged_rule_type": "unused",
      "resolved_rule_type": "unused",
      "started_rules": [

      ],
      "acknowledged_rules": [

      ],
      "resolved_rules": [

      ],
      "cause_field": null,
      "started_alert_id_field": null,
      "acknowledged_alert_id_field": null,
      "resolved_alert_id_field": null,
      "other_started_fields": null,
      "other_acknowledged_fields": null,
      "other_resolved_fields": null
    }
  }
}

Example cURL

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