To send or receive faxes with the Sinch Fax API, you need a Sinch phone number that is set to Fax and assigned to a fax service. This article answers the most common questions about numbers. For the full setup, including API credentials and code samples, see Getting started with the Fax API.
Do I need a number if I only send faxes?
Yes. Every outbound fax needs a From number. You can set it in either of two places:
- The from field in your API request.
- The default From number on your fax service, used when the request does not include one.
If neither is set, the API returns HTTP 422 with this message: No From number was specified or available on the project for use.
Can I test without buying a number?
Yes. Every new account gets one free US number for testing. To activate it:
- Log in to the Sinch Build Dashboard.
- Go to Numbers > Your virtual numbers.
- Wait a few seconds for the Activate your free test number banner. If it has not appeared after about 10 seconds, refresh the page once.
- Click Activate, click Get free test number, and wait for provisioning to finish.
The free test number is available for a limited time. Check your Sinch Build Dashboard for how long yours is valid.
Then send your test faxes to +19898989898. This test destination behaves like a real fax, including status updates and callbacks, and is never billed. You can also use the Fax > Try It Out page, which is pre-filled with this destination and a sample PDF:
While your account is in trial mode, you can only send real faxes to your verified numbers. To fax any number, upgrade your account.
Which numbers can be used for fax?
Fax is currently available on North American (+1) numbers only.
How do I set a number to Fax?
A new number first appears with Voice enabled. This is expected. To switch it:
-
On Your virtual numbers, click the number and open the Voice tab.
- Under Voice Configuration, select Fax.
- Select a Service and save your changes. Every account already has a Default Service.
The same steps apply to test numbers and purchased numbers.
Why do I see "No SMS service is available"?
This message means your account does not have an SMS service yet. Add one under SMS > Service APIs, then try again.
How do I get a number for live faxing?
- Click Upgrade in the top bar of the Sinch Build Dashboard to add funds and unlock live sending.
- Go to Numbers > Get virtual numbers and buy a number.
- Set the number to Fax and assign it to your service, as described above.
Can I keep my existing fax number?
US and Canadian numbers can be moved to Sinch by porting. See Number Porting for USA/Canada.
Comments
0 comments
Please sign in to leave a comment.