---
title: "Send a fax"
method: POST
path: "/accounts/{user_id}/outbox"
tags: ["Outbox"]
---

# Send a fax

`POST /accounts/{user_id}/outbox`

Send a fax to one or more destinations. For corporate members without a fax number assigned set the 'from' parameter to 'no_number'. (Permitted scopes: **fax:all:edit**, **fax:fax:edit**). To randomly select one of the available numbers per recipient, use comma-separated string.

## Path parameters

- `user_id` string, required

## Request body

- PayloadOutbox — Model for creating new outbound fax. **Note:** At least one of `files` or `from_fax` must be provided.
  - `from` string, required — Number to use for sending the fax. Use comma-separated string to randomly select one of the numbers per-recipient
  - `to` string[], required — List of fax destination numbers
  - `files` string[] — List of file names to send. Files should be uploaded beforehand. **Required unless `from_fax` is provided.** Can be combined with `from_fax` to append additional files before the referenced fax file.
  - `from_fax` object — Reference to an existing fax whose file to reuse (resend/forward). **Required unless `files` is provided.** Can be combined with `files` to prepend additional documents before the referenced fax file.
    - `fax_id` string, required — Session ID of the fax to reuse (the 'id' field from fax list/send responses)
    - `user_id` string — User ID who owns the fax. Use 'self' for your own faxes, or a member ID for corporate subordinate faxes. Defaults to 'self'.
  - `comment` OutboxComment — Comment to set for the fax job
    - `tags` string[]
    - `text` string
  - `options` OutboxOptions — Additional configuration for sending a fax
    - `enhancement` boolean — Text enhancement. Set to True to optimize fax file for text.
    - `retry` RetryOptions — Fax retry settings
      - `count` integer — Number of tries to send the fax
      - `delay` integer — Delay in seconds between two retries
    - `partially_sent_retry` boolean — Enable automatic retry for partially sent faxes. Please make sure that the remote will accept chunked submissions before using it
  - `send_time` string — Date when to send the fax. Format: **YYYY-MM-DD HH:mm:ss +HHMM**
  - `return_ids` boolean — Return scheduled fax IDs to use for tracking and with webhooks
  - `resolution` 'fine' | 'superfine' — Fax resolution. Valid values: **fine**, **superfine**
  - `cover_page` OutboxCoverPage — Fax cover page
    - `name_to` string, required — TO field on the cover page
    - `name_from` string, required — FROM field on the cover page
    - `subject` string, required — SUBJECT field on the cover page
    - `flags` CoverPageFlags[] — Cover page flags
    - `message` string — MESSAGE field on the cover page
    - `include_company_logo` boolean — Use company logo on the cover page

## Response `201`

Outbox fax has been created successfully

- SendFaxResponse — Send fax handle response, will contain Destination-to-ID mapping if the corresponding flag was provided
  - `ids` object — Destination-to-ID mapping

## Other responses

- `400` — Error object in case there's a problem with given data
- `500` — Error object in case there's a server error

---

[API](https://skmtc.net/fax/apis/fax-plus-rest-api.md) · [All operations](https://skmtc.net/fax/apis/fax-plus-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/fax/fax-plus-rest-api/revisions/c1afc85d2c15/schema)