Send fax
send_faxSend documents or plain text as a fax. Specify the fax number, attach files or write text, and enable test mode to avoid real charges.
Instructions
Sends documents or plain text as a fax through PixelLetter, without posting a letter. Additional services such as registered mail do not apply to faxes.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| text | No | Letter text as plain text, no HTML. Long texts run onto more pages automatically, your sender address is added by PixelLetter. "%Unterschrift%" on its own line inserts the signature stored in your PixelLetter account. | |
| files | No | Absolute paths of the documents to send, for example the PDF written by pdf-letter-mcp. Several files are converted and merged into one letter, in this order. Allowed: .pdf, .doc, .xls, .ppt, .rtf, .wpd, .psd, and PDF is the only type that always works. | |
| address | No | Recipient address, one line per array entry, country included. PixelLetter typesets it. Required when no file is sent. | |
| control | No | Raw value for the control field of the interface. The only value in public use is NODUPLEX, which the duplex parameter sets for you, so only reach for this when PixelLetter gave you another token. | |
| subject | No | Subject of the letter. | |
| location | No | Dispatch centre: 1 = Munich (DE), 2 = Hausleiten near Vienna (AT), 3 = Hamburg (DE). Default of the API is 1. | |
| testMode | Yes | Test mode. true runs the order exactly like a real one but PixelLetter never prints, never sends and never charges. false really sends the letter. Always required, so nothing goes out by accident. | |
| faxNumber | Yes | Fax number in international format, for example "+49 89 72448483". | |
| inlineFiles | No | Documents passed as base64 instead of a path. | |
| transaction | No | Your own transaction id or short note. PixelLetter returns it with the response. |