Create an API channel (custom integration)

📍 Where to find it: Inboxes → Add a channel → API

The API channel lets you connect a custom message source (your own app, a channel that isn't listed) to Madyis Hub via the API and webhooks.

How it works

You create an "API" inbox with a name and, optionally, a webhook URL (Madyis Hub will send events there). Madyis Hub generates an inbox identifier and an HMAC token. Your app sends incoming messages to the Madyis Hub API and receives your replies through the webhook. HMAC can be made mandatory to secure the exchanges.

Step by step

1. Inboxes → "Add inbox" → "API" card.
2. Give the inbox a name and, if needed, a webhook URL (starting with http).
3. Click "Create".
4. In the "Configuration" tab, copy the "inbox identifier" and the HMAC token.
5. Connect your app to the API using these credentials; enable mandatory HMAC verification if needed.

Good to know

• The API channel is meant for developers: keep it for when no standard channel fits.
• The webhook secret can be reset from the settings if needed.