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
messagestring
inboundWebhookUrlstring or nullformat: "uri"
statusWebhookUrlstring or nullformat: "uri"

Errors

400
Bad Request Error
401
Unauthorized Error
500
Internal Server Error