Credentials
Manage SIP credentials for username/password authentication on your trunks.
Introduction
Credentials provide username/password-based authentication for your SIP trunks. Each credential consists of a unique username and password combination that SIP clients can use to authenticate when making or receiving calls through your trunk.
Multiple credentials can be created for a single trunk, allowing different users, devices, or applications to connect with separate authentication details. This provides flexibility in managing access and tracking usage across different endpoints.
Security Note: Passwords are write-only and never returned in API responses. Once set, passwords cannot be retrieved - only updated or reset.
Best Practice: Use strong passwords (minimum 8 characters) with a mix of uppercase, lowercase, numbers, and special characters. Rotate credentials regularly for enhanced security.
Use Cases
Dynamic IP Environments
Perfect for remote workers, mobile devices, or any scenario where the source IP address changes frequently. Username/password authentication works regardless of network location.
Multi-User Access
Create separate credentials for different users or departments, making it easier to track usage and manage access permissions independently.
SIP Client Integration
Configure softphones, desk phones, or PBX systems with unique credentials for reliable authentication without IP whitelisting requirements.
Combined Authentication
Use credentials alongside IP ACL for maximum security - requiring both valid credentials AND whitelisted IP addresses for authentication.
Available Operations
Learn about the structure and attributes of credential objects
Add new SIP credentials to a trunk with username and password
List all credentials associated with a trunk with pagination support
Modify existing credential properties like password, status, or description
Permanently remove credentials from a trunk
Quick Start: Begin by reviewing the credential object structure, then create your first credential to start authenticating SIP clients to your trunk.