Skip to main content
Outgoing webhooks tell your own systems when something changes in your workspace. When something happens in your workspace, such as an app being published or the AI builder finishing a message, Base44 sends a signed request to the URL you choose, so your systems stay up to date without checking for changes.
Outgoing webhooks are available on the Business and Enterprise plans, and only workspace owners and admins can manage them. Your developers need a receiver at the URL first. To learn how to build one, see the outbound webhooks overview.
The Outgoing tab listing 4 webhooks: 2 active, 1 paused and 1 pending

Outgoing webhooks on the Webhooks page

​
Creating a webhook

Create a webhook for each URL that should receive events. You can create up to 10 per workspace. A new webhook is Pending and receives nothing until you activate it. After you create it, Base44 shows your workspace’s public signing key, which your receiver uses to confirm each request came from Base44. The key is safe to share with your developers. To create a webhook:
  1. Click your workspace name at the bottom left and click Settings.
  2. Click Webhooks in the sidebar, then click the Outgoing tab.
  3. Click Create webhook.
  4. Enter the Endpoint URL. It must start with https://.
  5. Under Events to send, select the events this URL should receive.
  6. (Optional) Enter a Description so your team knows what the webhook is for.
  7. Click Create webhook.
The Create webhook form with an endpoint URL, 3 selected events and a description

Creating a webhook

​
Activating a webhook

Activating sends a test event to your URL. The webhook becomes Active when your receiver answers and returns the code in the test event. If activation doesn’t complete, Base44 says why, for example that your endpoint didn’t answer in time or didn’t return the code. Fix the receiver and activate again. To activate a webhook:
  1. Click your workspace name at the bottom left and click Settings.
  2. Click Webhooks in the sidebar, then click the Outgoing tab.
  3. Click the More actions icon next to the webhook and select Activate.

​
Managing webhooks

Pause a webhook while your receiver is being updated, change what it receives, or remove it. A webhook that fails for several days in a row is Auto-paused by Base44. When your receiver works again, resume it, and Base44 runs the activation test again before it starts sending. To manage a webhook:
  1. Click your workspace name at the bottom left and click Settings.
  2. Click Webhooks in the sidebar, then click the Outgoing tab.
  3. Click the More actions icon next to the webhook and select an option:
    • Send test event: Sends a test event to check your receiver.
    • Edit endpoint: Changes the URL, the events or the description. Changing the URL stops deliveries until you activate the new URL.
    • Pause deliveries or Resume deliveries: Stops or restarts sending. Events that happen while a webhook is paused aren’t sent later.
    • Delete endpoint: Stops sending to the URL immediately.
The More actions menu open on an active webhook, with Send test event, Edit endpoint, Pause deliveries and Delete endpoint

Managing a webhook

​
Managing the signing key

Every request is signed with your workspace’s key. Rotating replaces it with a new one: Base44 signs with both the old and the new key for 24 hours, so your receiver keeps working while your developers add the new key. When they’re done, click Finish rotation to stop using the old key sooner.
Revoke stops Base44 signing with a key immediately. Receivers that only have that key reject every delivery until they get the new one. For a routine change, rotate the key instead.
To rotate the signing key:
  1. Click your workspace name at the bottom left and click Settings.
  2. Click Webhooks in the sidebar, then click the Outgoing tab.
  3. Click See public keys.
  4. Click Rotate key, then click Rotate key to confirm.
The Public signing keys dialog during a rotation, with the current key, the old key's stop date and Finish rotation

The signing keys during a rotation