---
title: "List incoming webhooks"
method: GET
path: "/api/v4/hooks/incoming"
tags: ["webhooks"]
---

# List incoming webhooks

`GET /api/v4/hooks/incoming`

Get a page of a list of incoming webhooks. Optionally filter for a specific team using query parameters.
##### Permissions
`manage_webhooks` for the system or `manage_webhooks` for the specific team.

## Query parameters

- `page` integer
- `per_page` integer
- `team_id` string

## Response `200`

Incoming webhooks retrieval successful

- 38cb7293IncomingWebhook[]
  - `id` string — The unique identifier for this incoming webhook
  - `create_at` integer — The time in milliseconds a incoming webhook was created
  - `update_at` integer — The time in milliseconds a incoming webhook was last updated
  - `delete_at` integer — The time in milliseconds a incoming webhook was deleted
  - `channel_id` string — The ID of a public channel or private group that receives the webhook payloads
  - `description` string — The description for this incoming webhook
  - `display_name` string — The display name for this incoming webhook

## Other responses

- `400` — Invalid or missing parameters in URL or request body
- `401` — No access token provided
- `403` — Do not have appropriate permissions

---

[API](https://skmtc.dev/infomaniak/apis/api-reference-developer-tools.md) · [All operations](https://skmtc.dev/infomaniak/apis/api-reference-developer-tools/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/infomaniak/api-reference-developer-tools/revisions/667aae28fec6/schema)