> ## Documentation Index
> Fetch the complete documentation index at: https://docs.blinkops.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List Incoming Webhooks

Get a list of incoming webhooks for the authenticated user.

**Required Permissions**: `manage_webhooks` for the team. System admins can retrieve all webhooks using `manage_others_incoming_webhooks`.

<Note>
  External Documentation

  To learn more, visit the [Mattermost documentation](https://developers.mattermost.com/api-documentation/#/operations/GetIncomingWebhooks).
</Note>

## Parameters

<div className="integrations-table">
  | Parameter        | Description                                        |
  | ---------------- | -------------------------------------------------- |
  | Page             | The page number to retrieve, starting at `0`.      |
  | Per Page         | The maximum number of items to retrieve per page.  |
  | Return All Pages | Automatically fetch all resources, page by page.   |
  | Team ID          | The ID of the team to filter incoming webhooks by. |
</div>

## Example Output

```json theme={"dark"}
{
	"incoming_webhooks": [
		{
			"id": "wdou1rmw5igixj9c8frntsw77y",
			"create_at": 1779101658211,
			"update_at": 1779101658211,
			"delete_at": 0,
			"user_id": "jm8qd6w6abdf8f981omo6dzuao",
			"channel_id": "5p8ahx9ep7bsjjkkgrk3bx6nth",
			"team_id": "eot4ncpgd78eiqxdyqox3tqcho",
			"display_name": "",
			"description": "",
			"username": "",
			"icon_url": "",
			"channel_locked": false
		}
	],
	"total_count": 1
}
```

## Workflow Library Example

[List Incoming Webhooks with Mattermost and Send Results Via Email](https://library.blinkops.com/workflows/list-incoming-webhooks-with-mattermost-and-send-results-via-email)

<div className="iframe-wrapper">
  <div className="iframe-media">
    <img src="https://mintcdn.com/blinkops-2/ojHYuDeYX5FWuN8a/img/Icons/play-box.svg?fit=max&auto=format&n=ojHYuDeYX5FWuN8a&q=85&s=b8af968e71438a9499c3223c9bd29fb2" alt="Workflow Library" width="16" height="16" data-path="img/Icons/play-box.svg" />

    Preview this Workflow on desktop
  </div>

  <iframe className="iframe" src="https://library.blinkops.com/workflows/list-incoming-webhooks-with-mattermost-and-send-results-via-email/canvas" />
</div>