---
title: "send message · RUAL Documentation"
description: "Send a message into a mssgs channel using an incoming webhook URL. Only the Webhook URL and message are required; the other pins map to the rich message…"
canonical: https://docs.rual.nl/block-types/mssgs/mssgs_send_message
language: en
---

# send message

This block is part of the [`mssgs`](https://docs.rual.nl/block-types/mssgs) group and was last modified in core [`v15.0.0`](https://docs.rual.nl/core-versions/150000).

Send a message into a mssgs channel using an incoming webhook URL. Only the Webhook URL and message are required; the other pins map to the rich message_container options.

- flow `flow`

- Webhook URL required `value` The mssgs incoming webhook URL (channel → webhooks). The URL itself is the secret; no auth header is needed.

- message required `value` Main message text (the message_container description). Required by the gateway.

- title `value` Title at the top of the embed. Defaults to the webhook's name when empty.

- title url `value` Makes the title a clickable link.

- sub title `value` Smaller text shown below the title.

- color `value` Accent color: blue, green, red, yellow, purple or orange. Default: blue. • Suggestions: `blue` `green` `red` `yellow` `purple` `orange`

- type `value` Message style: embed_message (default) or system_message. • Suggestions: `embed_message` `system_message`

- avatar url `value` Avatar image URL shown with the message.

- bot name `value` Custom bot name to display as the sender.

- fields `array ` Array of key-value fields shown in the embed, e.g. `[{"field":"Status","value":"Done"}]`.

- actions `array ` Array of action buttons, e.g. `[{"label":"Open","type":"url:https://..."}]` or a `trigger:{guid}` action.

- flow `flow`

- response `object` The webhook's JSON response (e.g. `{"success": true}`).

- success `condition` Returns true if the message has been sent.

- error `value` Returns the error in case success is `false`.

| `mssgs` |
| --- |
| `webhook` |
| `channel` |
| `message container` |
| `send mssgs` |

A typical wiring for [send message](https://docs.rual.nl/block-types/mssgs/mssgs_send_message): [value](https://docs.rual.nl/block-types/value/value_default) feeds the `webhook` pin; [concatenate values](https://docs.rual.nl/block-types/value/value_concatenate) feeds the `message` pin; [branch](https://docs.rual.nl/block-types/flow/branch) feeds the `flow` pin; the `flow` out pin feeds [funnel](https://docs.rual.nl/block-types/funnels/funnel).

![Studio canvas example for the send message block: typical wiring for send message.](https://docs.rual.nl/canvas-examples/mssgs_send_message.png)

### Commonly used with

In production blueprints, this block is most often wired together with:

- [value](https://docs.rual.nl/block-types/value/value_default): feeds into this block. Simply returns the provided value.

- [concatenate values](https://docs.rual.nl/block-types/value/value_concatenate): feeds into this block.

- [branch](https://docs.rual.nl/block-types/flow/branch): feeds into this block.

- [funnel](https://docs.rual.nl/block-types/funnels/funnel): this block feeds into it.

- [custom field](https://docs.rual.nl/block-types/object/object_get_custom_field): feeds into this block. get the value of a custom field with a custom value block, or dynamic value.

### Version history

Introduced in [`v15.0.0`](https://docs.rual.nl/core-versions/150000).