Skip to content
Proud to collaborate with Microsoft for Startups

slack.message.send ​

Send a Slack message with an organization-scoped Slack connection.

Overview ​

PropertyValue
Workflow typeAtomic
LibraryApp-slack
Version1.0

Input Schema ​

FieldTypeRequiredDefaultDescription
organization_uuiduuidYes—Organization that owns the Slack connection
connection_uuiduuidYes—Slack CloudConnection UUID
channelstringYes—Slack conversation id or name
textstringYes—Message text with Slack mrkdwn support
blocksjsonNo—Optional Block Kit blocks list
thread_tsstringNo—Thread timestamp for replies
usernamestringNo—Optional bot display name override
icon_emojistringNo—Optional bot icon override
unfurl_linksbooleanNo—Slack unfurl_links flag
unfurl_mediabooleanNo—Slack unfurl_media flag
workflow_run_idstringNo—Parent DAG run id (auto-injected by the engine when used as a DAG step)

Output Schema ​

FieldTypeRequiredDefaultDescription
channelstringNo—Slack channel id that received the message
message_tsstringNo—Slack message timestamp
thread_tsstringNo—Thread timestamp for follow-up replies
permalinkstringNo—Slack permalink when resolved
workflow_run_idstringNo—Parent DAG run id (auto-injected by the engine when used as a DAG step)
failure_reasonstringNo—Human-readable failure reason (engine-stamped)
failure_typestringNo—Failure category (engine-stamped)
failed_actionstringNo—Action that failed (engine-stamped)
failed_at_statestringNo—State where the workflow failed (engine-stamped)
failed_stepstringNo—DAG step that failed (engine-stamped)
failed_layerstringNo—DAG layer that failed (engine-stamped)
errorstringNo—Error message (engine-stamped)
error_typestringNo—Error class name (engine-stamped)

States ​

StateInitialTerminalSuccessAuto-advanceDescription
pendingYesNo—execute—
completedNoYesYes——
failedNoYesNo——

State Diagram ​

Transitions ​

FromActionToDescription
pendingexecutecompleted—
* (any state)failfailed—

API Usage ​

bash
POST /api/workflows/start
Content-Type: application/json

{
  "workflow_type": "slack.message.send",
  "initial_data": {
    "organization_uuid": "value",
    "connection_uuid": "value",
    "channel": "value",
    "text": "value"
  }
}