---
id: SCR-PFM-INT-011
title: Webhooks
route: '/console/{tenantId}/configuration/platform/integrations/webhooks'
surface: console
product_area: platform
module: integrations
revision: 1
status: draft
design_intent: proposed
implementation_evidence: observed
inference: []
source_sha:
  react-console: baf6dae382d6f41dce976c7f848667ccc37e076f
  services-platform: ad3f6a6582843008ed0f5a17b131878d15829af1
purpose: Investigate saved provider messages and request another processing attempt.
supports:
  - CAP-PFM-INT-013
permission: platform.integrations.read
entry_from:
  - '/console/{tenantId}/configuration/platform/integrations'
  - '/console/{tenantId}/configuration/platform/integrations/needs-attention'
exits_to:
  - '/console/{tenantId}/configuration/platform/integrations/{integrationKey}/connections/{connectionId}'
displays:
  - field: 'Received messages with endpoint, verification, processing state and time'
    source: listIntegrationWebhookEvents
  - field: 'One message’s digest, processing and produced events'
    source: getIntegrationWebhookEvent
  - field: Endpoints per connection
    source: listIntegrationWebhookEndpoints
actions:
  - label: Replay
    operation_id: replayIntegrationWebhookEvent
    permission: platform.integration-executions.operate
    confirm: true
  - label: Replay window
    operation_id: replayIntegrationWebhookEndpoint
    permission: platform.integration-executions.operate
    confirm: true
states:
  - empty
  - loading
  - error
  - read-only
validation:
  - BR-CAP-PFM-INT-013-08
  - BR-CAP-PFM-INT-013-09
patterns:
  - LibraryPage with breadcrumb navigation.
  - 'ReadState, Empty and shared error presentation for data reads.'
  - The Library access boundary controls entry; each action retains its implemented permission gate.
  - Received-message table and replay confirmation dialogs.
component: components/integrations/webhooks-screen.tsx
evidence:
  - 'react-console at baf6dae3: components/integrations/webhooks-screen.tsx'
controls: [TC-AVL-001, TC-AVL-004, TC-AVL-005, TC-AZ-001, TC-AZ-002, TC-AZ-003, TC-AZ-004, TC-CRY-001, TC-CRY-002, TC-CRY-003, TC-CRY-004, TC-DAT-001, TC-DAT-002, TC-DAT-003, TC-IAM-001, TC-IAM-002, TC-IAM-004, TC-IAM-005, TC-IAM-006, TC-LOG-002, TC-LOG-003, TC-LOG-004, TC-LOG-005, TC-MON-001, TC-MON-002, TC-PI-001, TC-PI-002, TC-PI-003, TC-PI-004, TC-PI-005, TC-SEC-001, TC-SEC-002, TC-SEC-003, TC-SEC-004, TC-TEN-001, TC-TEN-002, TC-TEN-003, TC-VEN-001, TC-VEN-002, TC-VEN-003]
---

# Webhooks

## What the Screen Is For

Investigate saved provider messages and request another processing attempt.

## What It Shows and Lets People Do

The message table exposes endpoint, verification, processing standing and receipt time. Detail includes the saved digest and derived events. Replay uses saved material and creates new processing records rather than mutating the earlier message into a queued message.

## States and Errors

The Library rejects entry without its read authority. Shared loading and error presentation handles data reads; mutation controls are gated separately. A visible control can still be refused by the API’s independent authorization or lifecycle validation.

## Patterns It Must Respect

LibraryPage with breadcrumb navigation. ReadState, Empty and shared error presentation for data reads. The Library access boundary controls entry; each action retains its implemented permission gate. Received-message table and replay confirmation dialogs.
