Send a fax

POST

/faxes

Send a fax. Files have size limits and page count limit validations. If a file is bigger than 50MB or has more than 350 pages it will fail with file_size_limit_exceeded and page_count_limit_exceeded respectively.

Expected Webhooks:

fax.queued

fax.media.processed

fax.sending.started

fax.delivered

fax.failed

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST '/faxes' \
--header 'Content-Type: application/json' \
--data-raw '{
    "client_state": "aGF2ZSBhIG5pY2UgZGF5ID1d",
    "connection_id": "234423",
    "from": "+13125790015",
    "from_display_name": "Company Name",
    "media_name": "my_media_uploaded_to_media_storage_api",
    "media_url": "https://www.w3.org/WAI/ER/tests/xhtml/testfiles/resources/pdf/dummy.pdf",
    "monochrome": false,
    "preview_format": "tiff",
    "quality": "high",
    "store_media": false,
    "store_preview": false,
    "t38_enabled": true,
    "to": "+13127367276",
    "webhook_url": "https://www.example.com/server-b/"
}'

Response Example

200 - Example 1

{
    "errors": [
        {
            "code": 0,
            "detail": "string",
            "meta": {},
            "source": {
                "parameter": "string",
                "pointer": "/json/pointer"
            },
            "title": "string"
        }
    ]
}

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Body Params application/json

Examples

Responses

🟢200OK

application/json

Unexpected error

Body

🟢202Accepted

Modified at 2025-06-16 19:14:41

View a list of faxes

Delete a fax