Frequently Asked Questions

Frequently asked questions

If your question isn’t answered below, please use our Search tool to find related topics in our documentation and on the Phone.com API Developer Community.


1. What can I do with the Phone.com API While in Beta?

2. What telephony features does your API offer?

3. How do I get an API key?

4. How much will it cost me to use your API?

5. What programming languages do you support?

6. How big a file can I upload?

7. How RESTful is your API?

8. How do I get a Phone.com phone number to use in my application?

9. Can I move my existing phone number to Phone.com?

10. I’m an existing Phone.com customer. How do I access the API?

11. Where can I get support with using your API?


1. What can I do with the Phone.com API While in Beta?

Our API lets you build a wide range of telephony features into your applications without having to host your own framework and services. In short, using the Phone.com API you can make and receive phone calls from your applications, send and receive SMS messages, and manage all of the telephony features and services available from Phone.com. Our API lets you add and manage Phone.com resources on the fly, allowing you to extend phone- and web-based resource management to your end users.

Important Note: While in Beta, we recommend that you only use the Phone.com API for testing purposes. Commercial use during Beta is not recommended. During Beta, we also ask that you submit feedback to the Phone.com API Developer Community, so that we can build an even better API.

Learn More: How Do Our Features Work Together? | What Features Does Phone.com Offer? | What Can I Do with the Phone.com API?


2. What telephony features does your API offer?

Phone.com offers over 40 telephony features, most of which you can implement, either by configuring them using settings in our Telephony Toolkit or by invoking our API services with simple REST requests.

Please be aware that the following service limits and features are in place during Beta development:

In the Phone.com API:

In the Telephony Toolkit:

Note that because this is a Beta test period, high-volume SMS or large batch calls are restricted.

Learn More: What Features Does Phone.com Offer? | API Reference Guide


3. How do I get an API key?

Once you have signed up for a Phone.com API Developer account, you will be assigned an API key when you set configuration details for your application in your account settings.

Learn More: Configuring Your Application | Get Started with Our API


4. How much will it cost me to use your API?

Signing up for a Phone.com API Developer account gives you full access to our cloud-based telephony services, our physical network and 24/7 customer support.

During Beta development, Phone.com API services will be available free of charge. See What telephony features does your API offer? above for a list of features available during Beta.


5. What programming languages do you support?

You can access the Phone.com API using any platform and language that can make an HTTPS request. However, objects and scripts must be provided and returned in JSON format. There are libraries for most languages that will encode and decode JSON.

Learn More: Systems and Requirements | JSON Support in the Phone.com API | Making a REST Request


6. How big a file can I upload?

The maximum size for media files or JSON objects included with a POST or PUT request to the Phone.com API is 20 MB.

Learn More: Formatting Guidelines | API Resource: /media


7. How RESTful is your API?

The Phone.com API is a REST API, uses the HTTP Protocol for all communications, and adheres to REST principals in its design and operation.

Learn More: Why REST? | Basic Phone.com API Requests and Responses | Making a REST Request


8. How do I get a Phone.com phone number to use in my application?

When you sign up for your Phone.com API Developer account, a local U.S. phone number is added to your account. You can change this number during the sign-up process or you can choose a different number after signup. You can also purchase additional local U.S., toll-free and global numbers.

Learn More: Setting Up Phone Numbers and Extensions | Pricing and Billing


9. Can I move my existing phone number to Phone.com?

Yes, any U.S. local or toll-free number that you own with another phone company (landline or mobile) can be ported over to Phone.com. Once you’ve submitted the required paperwork, Phone.com will handle the porting process, which can take anywhere from a few days to a couple weeks, depending on the carrier from which you are porting the number.

Learn More: Setting Up Phone Numbers and Extensions


10. I’m an existing Phone.com customer. How do I access the API?

Existing Phone.com customers who would like to add API access to their accounts should contact Phone.com Customer Support. Note that your API-related phone call use will not be free during Beta development, though SMS-related use will be free.

You will be billed the same per-minute rates for API-related phone calls as for those made on your current Phone.com service. As an existing customer with API access, you can purchase additional phone numbers, global numbers, Communicator extensions, devices and premium features.


11. Where can I get support with using your API?

If you have technical questions not covered in our API documentation, please join the Phone.com API Developer Community. We also offer 24x7 billing and account support at 1-844-PHONE-API (1-844-746-6327).