Set up the SMS (Twilio) webhook to receive messages

Connect your Twilio number to Omnifox and point its messaging webhook so every inbound SMS opens a conversation in the Inbox.

Jun 25, 2026

What you'll get

The SMS channel uses Twilio to send and receive text messages. To receive, you have to tell Twilio where to notify when an SMS arrives: that's Omnifox's incoming webhook URL. Once connected, every message opens a conversation in the Inbox.

Requirements

  • A Twilio account with an SMS-enabled number.
  • The Account SID and Auth Token from your Twilio console.
  • The number in E.164 format (with the + prefix, e.g. +15551234567).

Steps

  1. In Omnifox, go to Channels and click Connect channel.
  2. Pick SMS (Twilio) from the list.
  3. Paste your Account SID and Auth Token, and enter the Phone Number in E.164.
  4. Copy the Webhook URL Omnifox shows: https://omnifox.io/api/webhooks/sms.
  5. Save the channel.
  6. Open the Twilio console: Phone Numbers → Manage → Active Numbers → select your number.
  7. Under Messaging, in "A message comes in", choose Webhook, paste the URL from step 4, and leave the method as HTTP POST.
  8. Save the changes in Twilio.

How to verify

From another phone, send an SMS to the Twilio number. Within seconds a new conversation should appear in the Omnifox Inbox with the message text, and the sender is stored as a contact. Reply from the Inbox to confirm outbound delivery.

If it doesn't work

  • The SMS never reaches the Inbox: check that the Webhook URL in Twilio is exactly https://omnifox.io/api/webhooks/sms and that the method is POST, not GET.
  • Twilio reports error 11200 / 403: Omnifox validates the Twilio signature (the X-Twilio-Signature header). Make sure the Auth Token saved in the channel is correct and current; if you rotated it in Twilio, update it in the channel.
  • No routing: Omnifox identifies the channel by the recipient number (your Twilio number). Confirm the channel's number matches the one receiving the SMS.

Tips

  • If you use a Twilio Messaging Service instead of a standalone number, set the inbound webhook at the service level pointing to the same URL.
  • Keep the Auth Token in sync: rotating it in Twilio without updating the channel breaks signature verification and messages stop coming in.

Related articles

Was this helpful?

Related articles

Message us on WhatsApp