Outgoing webhooks: what they are, creating a subscription and selecting events

Learn what an outgoing webhook is in Omnifox and create your first subscription to receive events in your own system in real time.

Jun 26, 2026

Watch this step in the video · Webhooks: create a subscription

What is an outgoing webhook?

An outgoing webhook is an automatic notification that Omnifox sends to one of your URLs (an endpoint) whenever an event happens: a message arrives, a contact is created, a conversation is closed, a broadcast finishes, and so on. Instead of your system polling "did anything happen?" on a schedule, Omnifox pushes an HTTP POST request the moment it occurs, carrying the event data as JSON.

It is the way to wire Omnifox into your CRM, ERP, a spreadsheet, a serverless function, or any service that can receive a web request.

Before you start

  • You need the Manage webhooks permission (webhooks.manage) in your workspace.
  • You need a public endpoint reachable over HTTPS that responds with a 2xx status (ideally 200) within a few seconds.
  • Have your destination URL ready.

Steps to create a subscription

  1. Open the Webhooks section in the side menu.
  2. Click New webhook (top right).
  3. Under Configuration, fill in:
    • Name: a clear label, e.g. CRM sync.
    • Destination URL: the HTTPS address that will receive the events.
    • Retry count and Timeout (seconds): the defaults (3 and 30) are fine to start.
  4. Leave the Active toggle on.
  5. Under Signing secret you'll see an auto-generated secret (whsec_...). Click Copy and store it: you'll use it to verify the X-Omnifox-Signature header on your server.
  6. Under Events to subscribe, tick the checkboxes you care about, for example Message received (message.received) or Conversation created (conversation.created). At least one is required.
  7. Click Create webhook.

Available events

Events you can subscribe to include: Message received, Message sent, Conversation created, Conversation closed, Contact created, Contact updated, Broadcast completed and Channel health changed. Only tick the ones your integration truly needs so you don't receive extra traffic.

Verify it works

After saving, go back to the Webhooks list: your new entry appears with the Active toggle green. Trigger one of the subscribed events (for example, send yourself a test message) and open the webhook detail to see the delivery in the Delivery history with status Delivered and code 200.

If it doesn't work

  • Nothing arrives: confirm the Active toggle is on and that you ticked the right event.
  • Your server receives but rejects: respond with a fast 2xx; if you take longer than the Timeout, it counts as a failure.
  • Certificate errors: the URL must be HTTPS with a valid certificate.

Tip: start by subscribing a single event to a throwaway endpoint (such as webhook.site) so you can inspect the real payload before pointing it at your production system.

Related articles

Was this helpful?

Related articles

Message us on WhatsApp