Skip to main content
The X-Telnyx-Token header distinguishes multiple SIP connections sharing the same IP address.

Token requirements

RequirementValue
CharactersAlphanumeric (a-z, A-Z, 0-9) and hyphens
Length12-48 characters
ScopeGlobally unique across all Telnyx connections

SIP header format

X-Telnyx-Token: your-token-value
Include this header in all outbound SIP INVITE requests.

Configuration

PATCH /v2/ip_connections/
{
  "outbound": {
    "outbound_voice_profile_id": "uuid",
    "ip_authentication_token": "your-token-value"
  }
}

Authentication behavior

ConditionResult
IP matches + token matchesAuthenticated
IP matches + token missing/incorrectRejected
IP mismatch + token matchesRejected
Both the source IP and X-Telnyx-Token value must match the connection configuration.