---
title: "Send a Fax"
method: POST
path: "/Accounts/{AccountSid}/Faxes"
tags: ["Faxes"]
---

# Send a Fax

`POST /Accounts/{AccountSid}/Faxes`

Send a fax.

#### Permissions
The API token must include the following scopes: _Fax_.

## Path parameters

- `AccountSid` string, uuid, required

## Request body

- SendFaxRequest — Request body for sending a fax.
  - `MediaUrl` string, required — The URL hosting the received media.
  - `To` string, required — The phone number, in E.164 format, the fax was sent to.
  - `From` string, required — The phone number, in E.164 format, the fax was sent from.
  - `Quality` 'standard' | 'fine' | 'superfine' — The quality of the fax.
  - `StatusCallback` string — The URL to send a `POST` request when the status of a fax changes.

## Response `200`

The request has succeeded.

- FaxResponse — Response containing a single fax.
  - `account_sid` string — The unique identifier for the account this fax is associated with.
  - `api_version` string — The version of the SignalWire API.
  - `date_created` string — The date and time, in ISO 8601 format, the fax was created.
  - `date_updated` string — The date and time, in ISO 8601 format, the fax was updated.
  - `direction` 'inbound' | 'outbound' — Fax direction.
  - `from` string — The phone number, in E.164 format, the fax was sent from.
  - `media_url` string — The URL hosting the received media.
  - `media_sid` string — The unique identifier for the media instance associated with the fax instance.
  - `num_pages` string — The number of pages in the fax document.
  - `price` string — The cost of the fax.
  - `price_unit` string — The currency, in ISO 4217 format, of the price.
  - `quality` 'standard' | 'fine' | 'superfine' — Fax quality.
  - `sid` string — The unique identifier of the fax.
  - `status` 'queued' | 'processing' | 'sending' | 'delivered' | 'receiving' | 'received' | 'no-answer' | 'busy' | 'failed' | 'canceled' — Fax status.
  - `to` string — The phone number, in E.164 format, the fax was sent to.
  - `duration` integer — The time, in seconds, it took to deliver a fax.
  - `links` FaxLinks — Fax links.
    - `media` string — Media associated with this fax.
  - `url` string — The URL of this resource.
  - `error_code` string — Error code for this resource (if available).
  - `error_message` string — The description of this error (if available).

## Other responses

- `400` — 400 Bad Request response.
- `401` — 401 Unauthorized response.

## Changes

- **2026-01-15** `3c88f14db21e` — 6 breaking, 1 warning, 22 info
  - request body became required
  - removed the media type `application/x-www-form-urlencoded` from the request body
  - the `direction` response's property type changed from `string` to no type for status `200`
  - the `links` response's property type changed from `object` to no type for status `200`
  - …25 more

[Change history](https://skmtc.dev/signalwire/apis/compatibility-api/changes/Accounts/:AccountSid/Faxes/post.md)

---

[API](https://skmtc.dev/signalwire/apis/compatibility-api.md) · [All operations](https://skmtc.dev/signalwire/apis/compatibility-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/signalwire/compatibility-api/revisions/686ef84c2abc/schema)
