Voice - Receive an inbound call



To add this product to your account, contact a Telesign expert. This product is available for full-service accounts only.

This page explains how to use Telesign Voice to receive an inbound call. This is often used for setting up an inbound IVR system.



Telesign calls have a maximum call duration of four hours. You can also set a shorter maximum for an individual call.


You must have the following:

  • Telesign authentication credentials: Your Customer ID and API key.
  • Telesign phone number: A voice-capable phone number you have purchased from Telesign to use as a caller ID. Contact our Customer Support Team for details.
  • Customer event URL: A notification service you have set up for Telesign to post Event notifications to. See Voice - Receive Events with webhooks for instructions on how to set that up.

Be sure also to only use supported standards and codecs (see Voice - Supported standards and codecs).

Receive an inbound call

You receive an inbound call from Telesign via an incoming_call Event.

Example (body only)

  "event": "incoming_call",
  "reference_id": "534e1848-235f-482d-983d-e3e11a04f58a",
  "data": {
    "to": "15555551212",
    "from": "15558675309"

You then decide how you want to handle this event, for example by sending an Action to Telesign.