> ## Documentation Index
> Fetch the complete documentation index at: https://docs.vobiz.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# SIP Credentials List - Username & Password Auth
> Create SIP credentials in the Vobiz Console - username and password pairs that authorise PBX traffic to your outbound trunks. Walkthrough of the credentials list, details, and Create Credentials List form.
A **Vobiz SIP credential** is a username/password pair your PBX uses to authenticate against an outbound trunk. Use credentials when you can't whitelist a fixed IP - common for cloud‑hosted PBXes, dynamic IPs, or distributed setups.
```text URL theme={null}
https://console.vobiz.ai/app/sip/out/credentials
```
## The Credentials list
| Column | Meaning |
| ---------- | ----------------------------------------------------------------------- |
| **Name** | The credential username. |
| **ID** | Immutable UUID - quote in support tickets. |
| **Status** | `Active` accepts auth; `Inactive` blocks the username without deleting. |
Click any card to load its details on the right.
## Details panel
| Field | Meaning |
| ----------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Status toggle** | Flip between `Active` and `Inactive` without deleting. |
| **Username** | The SIP `username` your PBX presents. |
| **Credential ID** | Immutable UUID. |
| **Password** | Stored hashed - Vobiz never displays plaintext after creation. Click the eye icon (👁) to reveal the value if it's been re‑entered, or the copy icon (⧉) to copy. |
| **Metadata** | Created / Last Updated timestamps. |
## Create a credential
Click **+ Add Credential** to open the side panel.
| Field | Required | Rules |
| ------------ | -------- | -------------------------------------------------------------------------------------- |
| **Username** | ✅ | Letters, numbers, underscores, and hyphens only. No spaces or symbols. |
| **Password** | ✅ | Length **5–20** characters. Must be alphanumeric plus at least one of `~!@#$%^&*()_+`. |
| **Active** | – | Defaults on. Toggle off to provision but reject auth. |
Store the password in your password manager **now** - Vobiz won't display the plaintext again. If lost, you'll have to rotate by setting a new password.
Click **Create Credential**.
## Use the credential on a trunk
Once created:
1. Open an [Outbound Trunk](/platform/sip/outbound-trunks).
2. Edit the trunk and pick this credential from the **Credentials List** dropdown.
3. Save.
Your PBX should now authenticate against the trunk's SIP Domain with:
```text theme={null}
SIP Server / Domain: .sip.vobiz.ai
Username:
Password:
Realm: .sip.vobiz.ai
```
## Tips
* **One credential per environment.** Same logic as one trunk per environment - prevents a leaked staging password from being usable in prod.
* **Rotate passwords on offboarding.** Setting the credential to `Inactive` is faster than rotating, but rotation eliminates the risk that someone re‑enables it.
* **Username uniqueness.** Vobiz rejects duplicate usernames within your account - pick something descriptive like `acme-prod-pbx-01` instead of `sip1`.
## What's next
Attach this credential to a trunk.
IP whitelisting as an alternative to credentials.