Webhooks

Open Webhooks in the developer portal, enter an HTTPS endpoint, enable delivery, save the configuration, and use Test URL to validate connectivity.

The test action sends a JSON request with the test.ping event so you can validate routing and response handling.

{
  "event": "test.ping",
  "message": "Hello from Fortifiers!",
  "user": "developer@example.com"
}

Respond quickly with a 2xx status and move slow work to a queue. Log a safe event identifier rather than the full payload when it may contain customer information.

• Require HTTPS in production.
• Return a 2xx response after durable receipt.
• Make event processing idempotent.
• Monitor non-2xx responses and timeouts.

The portal currently supports one universal endpoint per workspace. Event schemas and signing guarantees must be treated as provisional until they are published in the versioned OpenAPI contract.