---
title: "Send Fax"
method: POST
path: "/fax/send"
tags: ["Fax"]
---

# Send Fax

`POST /fax/send`

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

## Request body

- FaxSendRequest
  - `recipient` string, required — 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` string[] — Use `files[]` to indicate the uploaded file(s) to fax This endpoint requires either **files** or **file_urls[]**, but not both.
  - `file_urls` 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
  - `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 `200`

successful operation

- FaxGetResponse
  - `fax` FaxResponse, required
    - `fax_id` string, required — Fax ID
    - `title` string, required — Fax Title
    - `original_title` string, required — Fax Original Title
    - `subject` string, nullable — Fax Subject
    - `message` string, nullable — Fax Message
    - `metadata` object, required — Fax Metadata
    - `created_at` integer, required — Fax Created At Timestamp
    - `sender` string, required — Fax Sender Email
    - `files_url` string, required — Fax Files URL
    - `final_copy_uri` string, nullable — The path where the completed document can be downloaded
    - `transmissions` FaxResponseTransmission[], required — Fax Transmissions List
      - `recipient` string, required — Fax Transmission Recipient
      - `status_code` 'success' | 'transmitting' | 'error_could_not_fax' | 'error_unknown' | 'error_busy' | 'error_no_answer' | 'error_disconnected' | 'error_bad_destination', required — Fax Transmission Status Code
      - `sent_at` integer — Fax Transmission Sent Timestamp
  - `warnings` WarningResponse[] — A list of warnings.
    - `warning_msg` string, required — Warning message
    - `warning_name` string, required — Warning name

## Other responses

- `4XX` — failed_operation

---

[API](https://skmtc.net/hellosign/apis/dropbox-sign-api.md) · [All operations](https://skmtc.net/hellosign/apis/dropbox-sign-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/hellosign/dropbox-sign-api/versions/2ea3f04008af/schema)