Centre d'aide Madyis Hub
en
Language
fr French en English

Webhooks (for developers)

Open in
View as Markdown Open in ChatGPT Open in Claude
Michael

Michael

Last updated on May 29, 2026

What it is for

A webhook lets Madyis Hub automatically notify your own systems as soon as something happens in your account: for example a new conversation, a new message, or a status change on a conversation. In practice, you provide a web address (a URL) that you own, and Madyis Hub sends a message (an HTTP call) to it for every event.

It is the ideal tool to connect Madyis Hub to your automations: trigger an action in your CRM, feed an internal tool, send an alert to another piece of software, and so on. Everything happens in real time, with no need to check manually.

ℹī¸ Good to know — This feature is mainly aimed at people comfortable with technical setups (developers, or an automation tool). If you have no system to connect, you can safely skip this article.

How to add a webhook

  1. Go to Settings → Integrations → Webhooks.
  2. Click Configure, then Add a new webhook.
  3. In the Subscription URL field, enter the web address that should receive the events (for example https://my-system.com/madyis-hub).
  4. Select the events you want to receive (new conversation, new message, status change, and so on). You can choose only some of them.
  5. Click Create webhook.

That's it: from now on, every time one of these events occurs, Madyis Hub automatically sends the information to your URL.

What you receive

For each event, Madyis Hub sends an HTTP POST request to your URL, with the details in JSON format (the event type, the conversation or message involved, and so on). Your system just needs to read this information and react however you like.

A few best practices

  • Your URL should be publicly reachable and ideally use HTTPS (a secure address).
  • It should respond quickly: simply acknowledge receipt, then process the content on your side.
  • You can create several webhooks pointing to different URLs, for example one per system you want to feed.

Editing or deleting a webhook

  1. Go back to Settings → Integrations → Webhooks.
  2. Find the webhook in the list.
  3. Use the actions next to it to edit it (change the URL or the events) or delete it.

If you stop receiving anything, first check that your URL is still online and responding correctly.