# List outgoing webhooks

Returns a list of all your Outgoing Webhook integrations. This endpoint [supports pagination](https://betterstack.com/docs/uptime/api/pagination/).

[endpoint]
base_url = "https://uptime.betterstack.com"
path = "/api/v2/outgoing-webhooks"
method = "GET"

[[query_param]]
name = "team_name"
description = "Filter outgoing webhooks belonging to a specified team when using [global API token](https://betterstack.com/docs/uptime/api/getting-started-with-uptime-api/#get-a-global-api-token)."
required = false
type = "string"

[[header]]
name = "Authorization"
description = "Bearer `$TOKEN`"
required = true
type = "string"
[/endpoint]

[responses]
[[response]]
status = 200
description = '''Returns list of existing Outgoing Webhook integrations'''
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
        }
      }
    },
    {
      "id": "17",
      "type": "outgoing_webhook",
      "attributes": {
        "name": "test with custom template",
        "url": "https://example.com",
        "trigger_type": "incident_change",
        "team_name": "My team",
        "on_incident_started": true,
        "on_incident_acknowledged": false,
        "on_incident_resolved": true
      },
      "relationships": {
        "custom_webhook_template": {
          "data": {
            "id": "18",
            "type": "custom_webhook_template"
          }
        }
      }
    }
  ],
  "included": [
    {
      "id": "18",
      "type": "custom_webhook_template",
      "attributes": {
        "http_method": "post",
        "headers_template": [
          {
            "name": "Content-Type",
            "value": "application/json"
          },
          {
            "name": "X-My-Header",
            "value": "my-value"
          }
        ],
        "body_template": "{\"data\":{\"id\":\"$INCIDENT_ID\",\"type\":\"incident\",\"hello\":\"world\",\"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\"}}}",
        "auth_username": "user",
        "auth_password": "password"
      }
    }
  ],
  "pagination": {
    "first": "https://uptime.betterstack.test/api/v2/outgoing-webhooks?page=1",
    "last": "https://uptime.betterstack.test/api/v2/outgoing-webhooks?page=1",
    "prev": null,
    "next": null
  }
}'''

[/responses]

#### Example cURL

```shell
[label Example]
curl --request GET \
  --url https://uptime.betterstack.com/api/v2/outgoing-webhooks \
  --header "Authorization: Bearer $TOKEN"
```

[info]
#### Looking for the details of a specific parameter?
Explore [the list of all Outgoing Webhook integration API parameters](https://betterstack.com/docs/uptime/api/outgoing-webhook-integrations-response-params/).
[/info]