Zum Hauptinhalt springen
POST
/
api
/
user
/
phone-numbers
/
sip-trunks
SIP-Trunk erstellen
curl --request POST \
  --url https://app.famulor.de/api/user/phone-numbers/sip-trunks \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "sip_trunk_type": "<string>",
  "phone_number": "<string>",
  "sip_username": "<string>",
  "sip_password": "<string>",
  "sip_address": "<string>",
  "sip_calling_format": "<string>",
  "inbound_authorization_type": "<string>",
  "allowed_inbound_ips": [
    {}
  ],
  "country_code": "<string>",
  "outbound_proxy": true
}
'
{
  "message": "SIP trunk created successfully.",
  "data": {
    "id": 42,
    "phone_number": "1000",
    "sip_username": "myuser",
    "sip_address": "sip.provider.com",
    "sip_calling_format": "+e164",
    "inbound_authorization_type": "auth",
    "allowed_inbound_ips": null,
    "outbound_proxy": false,
    "country_code": "US",
    "inbound_trunk_id": "ST_xxxxxxxxxxxx",
    "outbound_trunk_id": "ST_yyyyyyyyyyyy",
    "created_at": "2026-03-31T10:00:00.000000Z",
    "updated_at": "2026-03-31T10:00:00.000000Z"
  }
}
Dieser Endpunkt erstellt einen neuen SIP-Trunk. Die Plattform provisioniert automatisch Inbound- und Outbound-Trunks in der Voice-Infrastruktur anhand der uebergebenen Daten.

​
Body-Parameter

​
sip_trunk_type
string
erforderlich
Der Typ des SIP-Trunks: extension fuer eine SIP-Erweiterung oder number fuer eine Telefonnummer (DID). Das bestimmt das erwartete Format fuer phone_number.
​
phone_number
string
erforderlich
SIP-Erweiterung (1-15 Zeichen, z. B. 1000) bei sip_trunk_type = extension oder Telefonnummer im E.164-Format (z. B. +14155551234) bei sip_trunk_type = number.
​
sip_username
string
erforderlich
Benutzername fuer SIP-Authentifizierung (3-128 Zeichen)
​
sip_password
string
erforderlich
Passwort fuer SIP-Authentifizierung (mindestens 3 Zeichen)
​
sip_address
string
erforderlich
SIP-Serveradresse ohne Port (z. B. sip.provider.com)
​
sip_calling_format
string
erforderlich
Das ausgehende Rufnummernformat:
  • +e164 - International mit +-Praefix (z. B. +12025550123)
  • e164 - International ohne +-Praefix (z. B. 12025550123)
  • national - Nationales Format ohne Ländervorwahl (z. B. 0741926265)
​
inbound_authorization_type
string
erforderlich
Authentifizierung fuer eingehende Anrufe:
  • auth - Verwendet denselben SIP-Benutzernamen und dasselbe Passwort wie Outbound
  • ip - Whitelistet bestimmte IP-Adressen (erfordert allowed_inbound_ips)
​
allowed_inbound_ips
array
Array mit IP-Adressen, die eingehende Anrufe senden duerfen. Pflichtfeld, wenn inbound_authorization_type auf ip steht. Muss mindestens eine gueltige IP enthalten.
​
country_code
string
erforderlich
ISO-3166-2-Landercode, in dem sich der SIP-Trunk befindet (z. B. US, GB, DE). Bei sip_trunk_type = number wird das Land nach Moeglichkeit aus der Telefonnummer erkannt.
​
outbound_proxy
boolean
Leitet ausgehende Anrufe ueber eine feste IP-Adresse. Standard: false. Nur aktivieren, wenn Ihr SIP-Provider IP-basierte Authentifizierung fuer Outbound erfordert.

​
Antwort

​
message
string
Erfolgsmeldung
​
data
object
Das erstellte SIP-Trunk-Objekt (gleiche Felder wie bei SIP-Trunk abrufen)
{
  "message": "SIP trunk created successfully.",
  "data": {
    "id": 42,
    "phone_number": "1000",
    "sip_username": "myuser",
    "sip_address": "sip.provider.com",
    "sip_calling_format": "+e164",
    "inbound_authorization_type": "auth",
    "allowed_inbound_ips": null,
    "outbound_proxy": false,
    "country_code": "US",
    "inbound_trunk_id": "ST_xxxxxxxxxxxx",
    "outbound_trunk_id": "ST_yyyyyyyyyyyy",
    "created_at": "2026-03-31T10:00:00.000000Z",
    "updated_at": "2026-03-31T10:00:00.000000Z"
  }
}

​
Was nach der Erstellung passiert

Wenn Sie einen SIP-Trunk erstellen, passiert automatisch:
  1. Provisionierung eines Inbound-Trunks in der Voice-Infrastruktur - je nach inbound_authorization_type per Benutzername/Passwort oder IP-Authentifizierung
  2. Provisionierung eines Outbound-Trunks - mit der von Ihnen angegebenen SIP-Adresse und den Zugangsdaten, optional ueber den Outbound-Proxy
Falls die Provisionierung fehlschlaegt, wird der SIP-Trunk nicht gespeichert und ein 500-Fehler zurueckgegeben.

​
Naechste Schritte

Nach dem Erstellen koennen Sie den SIP-Trunk einem KI-Assistenten zuweisen: