Ruby Fax - Send a fax with a large file

This is a more advanced Ruby code sample to show how to send a fax with a large document. This code sample is based on the Ruby library for InterFAX available on Github.

This sample demonstrates how to upload a large file to InterFAX using the Document component and then sending a fax to a single recipient while referencing that previously uploaded file - all you need to do in order to change it is to provide a different fax number and a different path to the files that you would like to send. You can also change the size of the chunk that you will be uploading the file with.

     # read the file to send
file ='test.pdf', 'rb')

# create a new InterFAX Document
document = interfax.documents.create(

# upload each chunk
cursor = 0
while !file.eof?
  chunk =
  next_cursor = cursor + chunk.length
  # upload a specific chunk
  document.upload(cursor, next_cursor-1, chunk)
  cursor = next_cursor

# send the fax
  # a valid fax number
  faxNumber: "+11111111112",
  # the document URI
  file: document.uri


You can check on the status of this fax by following this sample code.

Contact us today

Talk to a member of our team about the benefits InterFAX can bring to your organization's communications processes.

Contact us today