Skip to main content
POST
/
fax
cURL
curl -X POST https://api.mintfax.com/v1/fax \
  -H "Authorization: Bearer fx_test_abc123..." \
  -H "Idempotency-Key: 550e8400-e29b-41d4-a716-446655440000" \
  -F "to=+12125551234" \
  -F "file=@document.pdf"
{
  "id": "9c1a2b3d-4e5f-6789-abcd-ef0123456789",
  "status": "queued",
  "to": "+12125551234",
  "created_at": "2026-01-15T10:30:00Z"
}

Documentation Index

Fetch the complete documentation index at: https://mintfax.com/docs/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Authorization
string
header
required

API key as Bearer token. Sandbox keys (fx_test_...) route to the sandbox environment. Live keys (fx_live_...) route to production.

Headers

​
Idempotency-Key
string

Client-generated key for idempotent submission (recommended). Duplicate keys return the original response without re-processing. Keys expire after 24 hours.

Maximum string length: 255

Body

multipart/form-data
​
to
string
required

Destination fax number in E.164 format

Example:

"+12125551234"

​
file
file
required

Document to fax (PDF, DOCX, XLSX, JPG, PNG, TIFF, HTML, TXT). Max 10MB.

​
webhook_url
string<uri>

Override the account-level webhook URL for this fax

​
retries
integer

Override default retry count for this fax

Required range: 0 <= x <= 10

Response

Fax queued successfully

​
id
string<uuid>
required
Example:

"9c1a2b3d-4e5f-6789-abcd-ef0123456789"

​
status
enum<string>
required
Available options:
queued
Example:

"queued"

​
to
string
required
Example:

"+12125551234"

​
created_at
string<date-time>
required
Example:

"2026-01-15T10:30:00Z"