SUPPORT.TWILIO.COM END OF LIFE NOTICE: This site,, is scheduled to go End of Life on February 27, 2024. All Twilio Support content has been migrated to, where you can continue to find helpful Support articles, API docs, and Twilio blog content, and escalate your issues to our Support team. We encourage you to update your bookmarks and begin using the new site today for all your Twilio Support needs.

Troubleshooting Webhook Delivery for Conversations or Chat

When using Programmable Chat or Conversations, you may want to create Webhooks to retrieve data or trigger an event when message are sent or members are removed. Our SDK-driven clients (like mobile phones or browser) will invoke the webhooks without further actions. This includes both Service-level webhooks and Channel-Scoped Webhooks, and as a default behavior helps avoid infinite feedback loops.

However, when using API or Server-side Helper Libraries to invoke some events e.g. send message/remove members (especially from your server), the webhook will not be invoked unless the header Webhook Enabled is set to true e.g. X-Twilio-Webhook-Enabled=true in your API request.

API Request with X-Twilio-Webhook-Enabled header

For cURL, an example of create member resource would look like this:

curl -H “X-Twilio-Webhook-Enabled:true” -X POST \
--data-urlencode “Identity=identity” \

For Axios, an example could look like this:

var axios = require('axios');
var qs = require('qs');
var data = qs.stringify({
'Identity': 'identity'

var config = {
method: 'post',
url: '',
headers: {
'X-Twilio-Webhook-Enabled': 'true',
'Authorization': 'Basic VFdJTElPX0FDQ09VTlRfU0lEOiRUV0lMSU9fQVVUSF9UT0tFTg==',
'Content-Type': 'application/x-www-form-urlencoded'
data : data

.then(function (response) {
.catch(function (error) {

Helper Libraries Request with X-Twilio-Webhook-Enabled header

For Helper Libraries, there is equivalent options when invoking the events and it varies from different programming languages. This table shows the differences:

Language Parameters
NodeJS, C#, PHP, Java xTwilioWebhookEnabled
Ruby, Python x_twilio_webhook_enabled
cURL X-Twilio-Webhook-Enabled
Twilio-CLI --x-twilio-webhook-enabled

An example of a NodeJS call with this option would be:
        identity: identity,
        roleSid: “RLXXXXXXXXXXXXXXXX”,
        xTwilioWebhookEnabled: true
.then(conversation => console.log(conversation.sid));

These are all available in respective resources (e.g. members/channel/message) in both Chat and Conversation. For example, in Conversation Message Resource Document or Chat Member Resource Document

Additional references

Have more questions? Submit a request
Powered by Zendesk