Update Phone Number Webhooks

​

Overview

​

Request Body

• phone_number (string, required): The phone number to update in E.164 format (e.g., +1234567890)
• voice_webhook_url (string, optional): URL for voice call webhooks
• disable_sms (boolean, optional): Set to true to disable SMS webhooks. Default: false
• enable_sms (boolean, optional): Set to true to enable SMS webhooks based on assigned assistant. Default: false
• provider (string, optional): Provider (twilio or telnyx). Auto-detected if not provided

​

SMS Webhook Management

​

Disabling SMS Webhooks

{
  "phone_number": "+15551234567",
  "disable_sms": true
}

• Twilio: Sets SMS webhook to https://demo.twilio.com/welcome/sms/reply
• Telnyx: Sets SMS webhook to empty URL
• Result: Incoming SMS messages are ignored

​

Re-enabling SMS Webhooks

{
  "phone_number": "+15551234567",
  "enable_sms": true
}

• Prerequisites: Phone number must be assigned to an assistant with sms_webhook_url configured
• Twilio: Sets SMS webhook to /twilio-sms-webhook and enables messaging service
• Telnyx: Sets SMS webhook to /telnyx-webhook
• Result: SMS messages are forwarded to assistant’s sms_webhook_url

​

Updating Voice Webhooks

{
  "phone_number": "+15551234567",
  "voice_webhook_url": "https://your-app.com/voice-webhook"
}

​

Combined Updates

{
  "phone_number": "+15551234567",
  "voice_webhook_url": "https://your-app.com/voice-webhook",
  "disable_sms": true
}

{
  "phone_number": "+15551234567",
  "voice_webhook_url": "https://your-app.com/voice-webhook",
  "enable_sms": true
}

​

Response

{
  "success": true,
  "phone_number": "+15551234567",
  "provider": "twilio",
  "updated_webhooks": {
    "voice": "https://your-app.com/voice-webhook",
    "sms": "disabled (demo URL)"
  },
  "message": "Successfully updated 2 webhook(s) for +15551234567 via twilio"
}

​

Use Cases

1. Voice webhook updates - Change where voice call events are sent
2. Temporary SMS disable - Disable SMS during maintenance or testing
3. Emergency SMS disable - Quickly stop SMS processing if needed
4. Re-enable SMS after maintenance - Restore SMS functionality without reassigning phone numbers

​

Notes

• At least one of voice_webhook_url, disable_sms, or enable_sms must be provided
• Cannot set both disable_sms and enable_sms to true in the same request
• To enable SMS, the phone number must be assigned to an assistant with sms_webhook_url configured
• Voice webhooks can be updated independently of SMS webhook state