SofortFax API

Sende Faxe direkt aus deiner Software — ohne Browser, ohne manuelle Schritte. Die REST-API ist in beiden Abo-Tarifen enthalten und sofort nach dem Kauf nutzbar.

Übersicht

Die SofortFax API ermöglicht es, Faxe programmatisch zu versenden. Sie eignet sich für:

Praxissoftware (Dampsoft, CGM, Medistar), ERP-Systeme (SAP, Sage, Lexoffice), Automatisierungsplattformen (Zapier, Make), eigene Skripte und Anwendungen sowie jeden anderen Dienst der HTTP-Requests senden kann.

Authentifizierung

Jeder API-Request benötigt deinen persönlichen Token im Authorization-Header:

Authorization: Bearer sfx_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Den Token findest du unter sofortfax.de/abo-portal.php. Er beginnt immer mit sfx_. Gib ihn nicht weiter — er hat vollen Zugriff auf dein Abo.

Limits & Tarife

Das Limit gilt gemeinsam für Faxe die über die Website und über die API gesendet werden. Das Feld remaining in jeder Antwort zeigt dir, wie viele Faxe du noch hast.

POST /send-fax.php

Sendet ein Fax an die angegebene Nummer. Das PDF kann entweder als URL oder als Datei-Upload übergeben werden.

Parameter

Variante A — JSON Body (empfohlen)

Header: Content-Type: application/json

Variante B — Multipart-Upload

Header: Content-Type: multipart/form-data

Antworten & Fehler

{
  "success":   true,
  "fax_id":    "telnyx-uuid-123",
  "to":        "+498912345678",
  "from":      "+4930987654",
  "remaining": 6,
  "limit":     20
}

{
  "success": false,
  "error":   "Kein gültiger Bearer
Token."
}

{
  "success": false,
  "error":   "Monatliches Fax-Limit
erreicht (20 Faxe)."
}

{
  "success": false,
  "error":   "Ungültige Faxnummer:
'+49 abc'. Bitte E.164."
}

Beispiele

cURL

curl -X POST https://sofortfax.de/send-fax.php \
  -H "Authorization: Bearer sfx_dein_token" \
  -H "Content-Type: application/json" \
  -d '{
    "to":      "+498912345678",
    "pdf_url": "https://mein-system.de/dokument.pdf"
  }'

Python

import requests

response = requests.post(
    "https://sofortfax.de/send-fax.php",
    headers={"Authorization": "Bearer sfx_dein_token"},
    json={
        "to":      "+498912345678",
        "pdf_url": "https://mein-system.de/dokument.pdf",
    }
)
data = response.json()
print(data["fax_id"], "gesendet, noch", data["remaining"], "Faxe übrig")

PHP

$ch = curl_init('https://sofortfax.de/send-fax.php');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POST           => true,
    CURLOPT_POSTFIELDS     => json_encode([
        'to'      => '+498912345678',
        'pdf_url' => 'https://mein-system.de/dokument.pdf',
    ]),
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer sfx_dein_token',
        'Content-Type: application/json',
    ],
]);
$result = json_decode(curl_exec($ch), true);

Zapier / Make

URL:     https://sofortfax.de/send-fax.php
Methode: POST
Header:  Authorization: Bearer sfx_dein_token
         Content-Type: application/json
Body:    { "to": "{{faxnummer}}", "pdf_url": "{{pdf_link}}" }

FAQ

Zählen API-Faxe gegen mein Monatslimit?

Ja. Web-Faxe und API-Faxe teilen sich dasselbe Monatslimit. Das Feld remaining in der Antwort zeigt immer den aktuellen Stand.

Was passiert wenn das Limit erreicht ist?

Die API antwortet mit HTTP 429 und einer Fehlermeldung. Das Fax wird nicht gesendet. Das Limit wird am Ersten des Folgemonats automatisch zurückgesetzt.

Welches PDF-Format wird unterstützt?

Standard-PDF, max. 10 MB, max. 20 Seiten pro Fax. Die URL muss öffentlich erreichbar und ohne Login zugänglich sein.

Kann ich die eigene Faxnummer als Absender nutzen?

Ja. Wenn du eine eigene Faxnummer über das Abo hast, wird sie automatisch als Absender verwendet. Antworten auf dein Fax landen dann als PDF in deinem E-Mail-Postfach.

Wie bekomme ich meinen Token?

Nach dem Abo-Abschluss findest du deinen Token unter sofortfax.de/abo-portal.php. Einfach E-Mail-Adresse eingeben — Token anzeigen und kopieren.