## List the tenant's inbound webhooks (comms:read)

`GET /api/comms/v1/inbound-hooks`

Module: Comms · operationId: `listInboundHooks` · Tag: Inbound webhooks · Auth: access token (`Authorization: Bearer <accessToken>`)

### Responses

- **200** Endpoints (`application/json`)

Fields of the 200 answer:

- `items` (array of InboundEndpoint): The tenant's inbound webhooks
  - `config` (InboundConfig): Tunes the scheme to the sender; empty fields take the scheme's usual headers.
    - `idHeader` (string): Header with a unique delivery id; repeated ids are stored once
    - `prefix` (string): Text before the value, e.g. "sha256=" or "Bearer "
    - `signatureHeader` (string): Header with the signature (hmac_sha256) or the token (token)
  - `createdAt` (string (date-time)): Creation time
  - `createdBy` (string): Who created the endpoint
  - `enabled` (boolean): Disabled endpoints answer 404
  - `id` (string (uuid)): Endpoint id
  - `lastReceivedAt` (string (date-time)): Time of the last verified request
  - `lastRejectedAt` (string (date-time)): Time of the last rejected request
  - `lastRejectedReason` (string): Why the last request was rejected
  - `maxBodyBytes` (integer): Largest accepted body in bytes
  - `name` (string): Display name
  - `receivedCount` (integer): Verified requests received
  - `rejectedCount` (integer): Requests rejected by the check
  - `rev` (integer): Revision for optimistic locking (send it back as `rev`)
  - `scheme` (string): How the sender is verified
  - `secret` (string): Only in the answer that created or rotated it
  - `toleranceSecs` (integer): Allowed clock difference for standard_webhooks
  - `url` (string): Public URL the sender posts to

Example 200 answer:

```json
{
  "items": [
    {
      "config": {
        "idHeader": "X-Shop-Delivery",
        "prefix": "sha256=",
        "signatureHeader": "X-Shop-Signature"
      },
      "createdAt": "2026-10-01T10:20:00Z",
      "createdBy": "jonas.bauer@muster-it.example",
      "enabled": true,
      "id": "1a9e5c3b-7d2f-4e6a-b8c4-0d1e2f3a4b5c",
      "lastReceivedAt": "2026-11-18T07:55:32Z",
      "maxBodyBytes": 262144,
      "name": "Shop-Bestellungen",
      "receivedCount": 128,
      "rejectedCount": 2,
      "rev": 4,
      "scheme": "hmac_sha256",
      "toleranceSecs": 300,
      "url": "https://api.mbcom.cloud/api/comms/v1/hooks/f3Kq9ZpL2vXc8RtW1nYb4A"
    }
  ]
}
```

### Example request

```bash
curl -X GET 'https://api.mbcom.cloud/api/comms/v1/inbound-hooks' \
  -H "Authorization: Bearer $ACCESS_TOKEN"
```
