Docs / Integration API contract

Block Kit

Blocks are flattened to text rather than rendered, so a message written for Slack still reads sensibly:

  • header becomes bold text;
  • section contributes its text and each of its fields;
  • context contributes its text elements, joined; images are dropped;
  • divider becomes a line;
  • actions contributes buttons — up to 25, with text up to 75 characters and value up to 2,000 — and nothing else; selects, date pickers and overflow menus are dropped;
  • anything else, such as image or rich_text, is dropped.

Message text is a subset of Slack's mrkdwn. Drawn as formatting: *bold*, _italic_, ~strike~, `code`, ``` code blocks, bare http(s) links, <@user id> and <#channel id> mentions, and <!here>, <!channel> and <!everyone>. A backslash before a formatting character shows it literally. Not interpreted: Slack's <https://…|label> links (the label is not shown as link text), > quotes and list markers, which appear as the characters typed, and date formatting such as <!date^…>.

This page is made from docs/INTEGRATIONS.md.