Skip to navigation
Webhooks

Set your webhook URLs

View as Markdown

Register where MessageBlue delivers your events.

  • inboundWebhookUrl receives inbound_message and inbound_reaction events.
  • statusWebhookUrl receives delivery-status updates for outbound messages. A per-message status_callback, if you set one when sending, takes precedence over this account-level URL.

Both fields are optional; send only the one you want to change. Passing an empty value unsets that webhook and the account falls back to default behavior. Every delivery to these URLs is signed — see the Webhooks tag for the verification scheme.

Authentication

X-App-Idstring

Your MessageBlue App ID, sent in clear on every request. It is paired with request signing: each request is also signed with your App Secret (see the Authentication tag). The App Secret itself is NEVER transmitted — it is only the HMAC signing key.

Request

This endpoint expects an object.
inboundWebhookUrlstring or nullOptionalformat: "uri"

Destination for inbound_message and inbound_reaction events. Empty value unsets it.

statusWebhookUrlstring or nullOptionalformat: "uri"

Destination for delivery-status events. Empty value unsets it.

Response

Updated
messagestringOptional
inboundWebhookUrlstring or nullOptionalformat: "uri"
statusWebhookUrlstring or nullOptionalformat: "uri"

Errors

400
Bad Request Error
401
Unauthorized Error
500
Internal Server Error