Docs / Integration API contract

Incoming webhooks

POST https://<server>/hooks/<secret> with a JSON body, or a form with a payload field holding the JSON — the older shape many tools still send.

  • text, blocks, or both, with the same rules as chat.postMessage.
  • Success is HTTP 200 with the body ok, as on Slack.
  • The channel is fixed when the webhook is created; a channel field is ignored.
StatusErrorWhen
404invalid_webhookThe secret is unknown, replaced, or its app is deactivated
400invalid_payloadThe body is not JSON
400no_textNothing to post
404channel_not_foundThe channel is gone or archived
403not_in_channelA private conversation the bot has since left

Errors come back as {"ok": false, "error": "<code>"} rather than Slack's bare text.

This page is made from docs/INTEGRATIONS.md.