Outbound webhooks overview

• Keep your own records in sync when apps are created, published, taken offline, moved to trash or restored.
• Start your own workflows when an app goes live.
• Build a platform on Base44 that reacts to what your customers do in their workspaces.

​

How it works

1. Register an endpoint. In your workspace settings, or with a workspace API key. See Setting up endpoints.
2. Activate it. Base44 sends a signed test event, and your receiver echoes back the code it contains. Until then the endpoint stays Pending and receives nothing.
3. Verify each request. Every request is signed with your workspace’s Ed25519 key. See Verifying requests.
4. Handle retries. Delivery is at least once, so the same event can arrive more than once. See Delivery and retries.

​

What each request looks like

{
  "specversion": "1.0",
  "id": "evt_68c1d2e3f4a5b6c7d8e9f0a1",
  "source": "https://base44.com/workspaces/68a1b2c3d4e5f6a7b8c9d0e1",
  "type": "app.published.v1",
  "subject": "apps/68b0c1d2e3f4a5b6c7d8e9f0",
  "time": "2026-09-01T10:15:30.123Z",
  "datacontenttype": "application/json",
  "dataschema": "https://base44.com/webhooks/schemas/app.published.v1.json",
  "authtype": "user",
  "authid": "6899aabbccddeeff00112233",
  "data": {
    "app_id": "68b0c1d2e3f4a5b6c7d8e9f0",
    "workspace_id": "68a1b2c3d4e5f6a7b8c9d0e1",
    "owner_id": "6899aabbccddeeff00112233",
    "published_version": "68c2d3e4f5a6b7c8d9e0f1a2",
    "published_at": "2026-09-01T10:15:30.123Z"
  }
}

​

Limits