Webhook can notify teams when notifications are being sent. Set Notification webhooks on Sendbird Dashboard for your server to receive HTTP POST requests from the Sendbird server in JSON format, which contain information on all events within your Sendbird application.
Set up webhooks
- Log in the Sendbird Dashboard.
- Navigate to Settings > Notifications > Webhooks and turn on the feature.
- Enter the webhook URL for the Sendbird server to send a request and choose the events you wish to subscribe to.
Specifies the URL that Sendbird can send the the payload to.
Selects webhook events to listen to.
POST requests from the Sendbird server include the following headers.
Note: Upon selection, the Sendbird server will dispatch webhook events in JSON format to your specified server. This occurs whenever a real-time or batch notification is triggered. Including template variables can be enabled by request, allowing all webhooks to include these variables, as detailed in the payload format below.
x-sendbird-signature is used as a request header to ensure that the source of the request comes from the Sendbird server and the request is not altered by external influences. Based on both the
POST request body and your API token, the value of
x-sendbird-signature is generated through the
SHA-256 encryption on the the Sendbird server side.
To verify the request on your server side, create a comparison value exactly the same way as the Sendbird server does, and then check if the result is equal to the value of the
Note: Always use the master API token to generate and validate the signature because secondary API tokens won't work. You can find the master API token on the dashboard.
x-signaturerequest header can be used for verification. However, when the request body contains non-ASCII characters such as emojis, the encrypted value on your server side and the value of
x-signaturegenerated from the Sendbird server are always different. For this reason,
x-signaturecould be deprecated in the near future. Therefore, we recommend that you use
The following is the payload sample for notifications: