Portal Webhook Receiver
Component Detail
Infrastructure
medium complexity
backend
2
Dependencies
0
Dependents
0
Entities
0
Integrations
Description
HTTP endpoint that accepts inbound webhook POST requests from the external Dynamics-based portal. Validates request authenticity via HMAC signature or shared secret, enqueues valid payloads for processing by the External Portal Connector, and returns 200 immediately to prevent external portal retry storms. Rejects unauthenticated or malformed requests with appropriate 4xx responses.
portal-webhook-receiver
Responsibilities
- Expose a stable POST endpoint at a per-organization webhook URL
- Validate inbound request signatures to reject unauthenticated calls
- Deserialize and enqueue valid payloads for asynchronous processing
- Return fast acknowledgement responses to prevent external portal timeouts and duplicate retries
Interfaces
POST /api/v1/webhooks/portal/:orgId
validateSignature(headers: Headers, body: Buffer, secret: string): boolean
enqueuePayload(orgId: string, payload: RawPortalEvent): void
Relationships
Dependencies (2)
Components this component depends on