Want to provide feedback?

Write to docs@telesign.com.


If you are interested in trying TeleSign’s Voice API, sign up by navigating to our Voice API signup page.

Receive an Inbound Call with TeleSign’s Voice API

You can use TeleSign’s Voice API to receive an inbound call. This is often used for setting up inbound IVR.

Contents of this page:


TeleSign calls have a maximum call duration of four hours.


You must have the following:

  • TeleSign credentials - your customer ID and API key
  • TeleSign phone number - you must purchase a TeleSign phone number to use as a callerID. You can do this using the Phone Numbers API. Refer to the Get Started with the Phone Numbers API page.
  • For details about supported standards and codecs, see Supported Standards and Codecs*
  • If you plan to use events posted by TeleSign as a trigger for what action to take next with a call, you need a customer event URL on your server for TeleSign to post event information to. For more details, refer to the Set up the Customer Event URL section on the Voice API Reference page.
  • If you want to make choice about how to handle a call without needing an event posted by TeleSign as a trigger, you will need to review:

Receive an Inbound Call

You receive an inbound call from TeleSign via an incoming call event. The term ‘event’ is how TeleSign refers to any information sent to you.

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

When this information comes in, you can then decide how you want to handle it. This would be the basics for handling a call to something like an IVR system. You can give any commands you would like.

Next Steps

This section offers some suggestions for next steps to take.