A chat webhook lets external services post automated messages into an ISO Mate channel. A channel admin enables the webhook in Channel Settings, copies the webhook URL, then external tools send a POST request with a small JSON body to publish a message. It is ideal for build notifications, monitoring alerts, and status updates from other systems.
Enable a channel webhook
- Open Chat from the sidebar General group and select the channel.
- Open Channel Settings from the channel header (admin only) and go to the Webhook tab.
- Turn on Webhook Enabled.
- Use Copy URL to copy the Webhook URL for your external service.
Post a message via webhook
Send a POST request to the webhook URL with a JSON body. Only the message text is required, and you can override the display name and avatar of the posting bot.
POST /api/chat/webhook/{token}
Content-Type: application/json
{
"text": "Hello from my integration!",
"username": "My Bot",
"icon_url": "https://example.com/bot-avatar.png"
}Payload fields
- text: the message content, required, up to 4000 characters.
- username: an optional display name for the bot, up to 100 characters.
- icon_url: an optional avatar URL for the bot.
Messages posted this way appear in the channel labeled as a webhook, using the bot name you provide. The settings dialog also includes a cURL example you can copy to test quickly.
Common uses
- Build notifications: post CI and CD pipeline results such as success or failure.
- Monitoring alerts: forward alerts from external monitoring tools.
- Status updates: send automated updates from third party services.
Regenerate the token
If a webhook token may have been exposed, use Regenerate Token in the Webhook tab. Regenerating invalidates the current webhook URL, so update your external services with the new URL afterward. To manage the channel itself, see Using Team Chat Channels.
Automate your team updates into chat. Start your free 14-day trial.