with our programmable Fax API
Automate sending and receiving documents
without a fax machine or paper via our Fax API
The RingCentral Fax API allows you to integrate fax capabilities into
your custom applications. Send faxes, queue faxes, send and receive
in multiple formats, concatenate multiple documents into a single
document, automatically resend failed faxes, forward faxes, customize
cover sheets, and more.


Multiple file formats
formats including PDF, TIFF,
DOCX, DOC, XLXS, XLS,
RTF, HTML and more.

Queuing
Fax messages are automatically
queued and sent at a rate that
keeps you compliant.

Retry and forwarding
efficiently by avoiding
re-rendering, with automatic
built-in retries.

Two-way fax API
and receive faxes.

Automatic retries
numbers to successfully deliver
your faxes.

Built in cover page flexibility
templates or use your own.

Concatenate multiple files
multiple files of different formats
in a single API request.

Notifications and webhooks
notifications, including
webhooks, for new and updated
fax messages.

Flexible phone numbers
and update faxes for application
and personal phone numbers.

Delivery status
on successful fax delivery.

Read status
status via API and RingCentral
endpoint apps.

Email / SMTP
faxes using email.

Delete faxes
meet organization and user
archival requirements.

Proven scalability
used by some of the world’s
largest and most demanding
fax senders.
Fax API code samples
Adding fax to your application couldn’t be easier with our SDKs for C#, PHP, JavaScript, and Python.
- JavaScript
- Python
- PHP
- C#
var FormData = require('form-data');
formData = new FormData();
formData.append('json', new Buffer(JSON.stringify({
to: [ {'phoneNumber': recipient} ],
faxResolution: 'High',
coverPageText: "This is a demo Fax page"
})), {
filename: 'request.json',
contentType: 'application/json'
});
formData.append('attachment', require('fs').createReadStream('fax.jpg'));
platform.post('/account/~/extension/~/fax', formData)
.then(function (resp) {
console.log("FAX sent. Message status: " + resp.json().messageStatus)
});
builder = rcsdk.create_multipart_builder()
builder.set_body({
'to': [{'phoneNumber': recipient}],
'faxResolution': "High",
'coverPageText': "This is a demo Fax page from Python"
})
attachment = ('fax.jpg', open('fax.jpg','r').read(), 'image/jpeg')
builder.add(attachment)
request = builder.request(f'/restapi/v1.0/account/{accountId}/extension/{extensionId}/fax')
resp = platform.send_request(request)
$request = $rcsdk->createMultipartBuilder()
->setBody(array(
'to' => array(array('phoneNumber' => $recipient)),
'faxResolution' => 'High',
))
->add(fopen('fax.jpg', 'r'))
->request("/restapi/v1.0/account/{$accountId}/extension/{$extensionId}/fax");
$r = $platform->sendRequest($request);
RestClient rc = new RestClient(
Environment.GetEnvironmentVariable("clientId"),
Environment.GetEnvironmentVariable("clientSecret"),
false
);
await rc.Authorize(
Environment.GetEnvironmentVariable("username"),
Environment.GetEnvironmentVariable("extension"),
Environment.GetEnvironmentVariable("password")
);
var r = await rc.Restapi().Account(accountId).Extension(extensionId).Fax().Post(formData);
Simple API pricing, starting at free!
The RingCentral API is included with select RingCentral Office® plans. Additional toll-free and
international voice and fax minutes are available as add-ons with a minimal per minute fee.
Local Number
Unlimited faxing within
the US and Canada
FREE
Toll-free Faxing
Use your toll-free business number
$0.039/ min
after included per minute
* Call usage restrictions may apply. See Terms and Conditions.
Fax API frequently asked questions
To help you manage your business faxing, here are some of the most common questions
we get. Of course, you can always ask our community or contact our developer support
for any questions you might have.
What is Fax API?
Do I need a fax machine to use this API?
How do I customize cover sheets?
How do I join multiple fax documents into a single document?
What types of analytics are available?
We have offices all over the world, will this work for us?
Get more than communications.
Be part of the RingCentral community.

Live chat

Developer forum

RingCentral Professional Services™
