Fax

Send Fax

POST
/fax/send

Creates and sends a new Fax with the submitted file(s)

Authorization

api_key
AuthorizationBasic <token>

Your API key can be used to make calls to the Dropbox Sign API. See Authentication for more information. āœ… Supported by Try it console (calls sent in test_mode only).

In: header

Request Body

recipient*string

Recipient of the fax Can be a phone number in E.164 format or email address

sender?string

Fax Send From Sender (used only with fax number)

files?unknown

Use files[] to indicate the uploaded file(s) to fax

This endpoint requires either files or file_urls[], but not both.

file_urls?array<string>

Use file_urls[] to have Dropbox Fax download the file(s) to fax

This endpoint requires either files or file_urls[], but not both.

test_mode?boolean

API Test Mode Setting

Defaultfalse
cover_page_to?string

Fax cover page recipient information

cover_page_from?string

Fax cover page sender information

cover_page_message?string

Fax Cover Page Message

title?string

Fax Title

Response Body

application/json

application/json

curl -X POST "https://example.com/fax/send" \  -H "Content-Type: application/json" \  -d '{    "file_urls": [      "https://www.dropbox.com/s/ad9qnhbrjjn64tu/mutual-NDA-example.pdf?dl=1"    ],    "test_mode": "true",    "recipient": "16690000001",    "sender": "16690000000",    "cover_page_to": "Jill Fax",    "cover_page_message": "I\'m sending you a fax!",    "cover_page_from": "Faxer Faxerson",    "title": "This is what the fax is about!"  }'
{  "fax": {    "fax_id": "c2e9691c85d9d6fa6ae773842e3680b2b8650f1d",    "title": "example title",    "original_title": "example original title",    "subject": "example subject",    "message": "example message",    "metadata": [],    "created_at": 1726774555,    "sender": "me@dropboxsign.com",    "transmissions": [      {        "recipient": "recipient@dropboxsign.com",        "sender": "me@dropboxsign.com",        "sent_at": 1723231831,        "status_code": "success"      }    ],    "files_url": "https://api.hellosign.com/v3/fax/files/2b388914e3ae3b738bd4e2ee2850c677e6dc53d2"  }}