How to Set Up Twilio Webhooks for Sparkforge Calls and Messages

By Sparkforge Support Team ·Last reviewed May 3, 2026

If you bring your own Twilio account instead of using Sparkforge's phone, Twilio needs webhook URLs pointed at Sparkforge so inbound calls, SMS, and status updates land in your account.

If you use your own Twilio account rather than Sparkforge's built-in phone, Twilio has to know where to send incoming calls, messages, and call status updates. That's what webhooks are for. Configure them once per number and you're set.

Why webhooks are required

Twilio owns the phone numbers and routes the traffic. Sparkforge needs Twilio to forward each event — inbound call, inbound SMS, call status change — to a Sparkforge endpoint. Without webhooks, calls and texts never reach your Sparkforge inbox.

Voice webhook setup

  1. Log in to your Twilio account and open the phone numbers list.
  2. Click the phone number you want to configure.
  3. Set Routing region to US1 if it isn't already.
  4. Under Voice Configuration, set:
    • Configure with: Webhook, TwiML Bin, Function, Studio Flow, Proxy Service
    • A call comes in: Webhook
    • URL: https://services.sparkforgehq.com/phone-system/voice-call/inbound
    • HTTP: HTTP POST
    • Primary handler fails: leave as-is
    • Call status changes URL: https://services.sparkforgehq.com/appengine/twilio/incoming_call_status
    • HTTP: HTTP POST
    • Caller Name Lookup: Enabled (recommended)
  5. Click Save configuration.

Messaging webhook setup

  1. Set Routing region to US1 if it isn't already.
  2. Under Messaging, set:
    • Configure with: Webhook, TwiML Bin, Function, Studio Flow, Proxy Service
    • A message comes in: Webhook
    • URL: https://services.sparkforgehq.com/appengine/twilio/incoming_message
    • HTTP: HTTP POST
  3. Click Save configuration.

If your number is on a Messaging Service

  1. Open Active Numbers and click the linked Messaging Service.
  2. Open the Integration tab.
  3. Select Send a webhook and use:
    • Request URL: https://services.sparkforgehq.com/appengine/twilio/incoming_message
    • Fallback URL: https://services.sparkforgehq.com/appengine/twilio/incoming_message
  4. Click Save.

Frequently Asked Questions

Do I need this if I'm using Sparkforge's built-in phone?
No. Webhook setup is only required when you bring your own Twilio account. Sparkforge's native phone is preconfigured.
What happens if I skip the call status webhook?
Sparkforge will still get the call, but call status events (completed, no-answer, busy, failed) won't update in your account, which breaks workflows and reporting that depend on call outcome.
Why does the routing region need to be US1?
Sparkforge's services expect US1 routing. Other regions can introduce latency or routing issues for the inbound webhook traffic.
My number is attached to a Messaging Service. Where do the SMS webhooks go?
Configure the webhook on the Messaging Service itself under Integration, not on the individual phone number. The Messaging Service settings take over.

Was this article helpful?

Related Articles