Blocks

Phase	What happens
Now	`blocks` are validated and stored on the message. People see `text`; clients don’t render blocks yet, and push notifications always use `text`.
Next (Phase 1b)	Workchats clients (web, desktop, mobile) render the six block types below. Link buttons work. Action buttons stay hidden — no card shows a dead button.
Later (Phase 2)	Action buttons become clickable and send an `interaction` callback. See Callbacks & signature verification.

Phase

What happens

Now

blocks are validated and stored on the message. People see text; clients don’t render blocks yet, and push notifications always use text.

Next (Phase 1b)

Workchats clients (web, desktop, mobile) render the six block types below. Link buttons work. Action buttons stay hidden — no card shows a dead button.

Later (Phase 2)

Action buttons become clickable and send an interaction callback. See Callbacks & signature verification.

Block types

At most 50 blocks per message, 16 KB total. An unknown type or a field a type doesn’t accept returns 400 invalid_blocks.

header

{ "type": "header", "text": "New lead from Meta Lead Ads" }

A bold title line.

section

{ "type": "section", "text": "**Sarah Chen** · Head of Ops at **Acme Ltd**" }

A body paragraph. text supports a Markdown subset: **bold**, _italic_, [label](url), and line breaks.

fields

{
  "type": "fields",
  "fields": [
    { "label": "Email", "value": "[email protected]" },
    { "label": "Campaign", "value": "Meta Lead Ads (Paid)" }
  ]
}

A two-column label/value grid. 1 to 10 fields.

actions

{
  "type": "actions",
  "elements": [
    { "type": "button", "text": "Open in Leadey", "url": "https://app.leadey.ai/dashboard/leads/lead_mul0oe5wo0dgol", "style": "primary" },
    { "type": "button", "text": "Claim", "action_id": "lead.claim", "value": "lead_mul0oe5wo0dgol" }
  ]
}

A row of 1 to 5 buttons. Each button is either a link (url — opens in the browser, no callback) or an action (action_id + optional value — sends an interaction callback once clicks ship in Phase 2). Never both on the same button. style is primary, danger, or omitted.

context

{ "type": "context", "text": "Leadey · Corpwise · just now" }

A small grey footer line.

divider

{ "type": "divider" }

A horizontal rule. Takes no other fields.

Full field-level schema on Block types.

Getting Started

Guides

Reference

Changelog

Policies

Block types

Editing

​Block types

​Editing

Block types

Editing