# Create and Edit PJSIP Extensions

Use this page to create or edit a phone extension that registers as a PJSIP endpoint. The form works against the tenant currently selected in the top bar.

The screenshots use the **Canistracci Oil** demo extension **101 Bella Stone**. Creating and editing use the same form: a new extension opens with tenant defaults, while an existing extension opens with saved values.

## Creating and editing

<table id="bkmrk-actiondescriptioncre"><thead><tr><th>Action</th><th>Description</th></tr></thead><tbody><tr><td>Create</td><td>Open Configuration &gt; Extensions and select New PJSIP peer. Fill the required fields and select Save.</td></tr><tr><td>Edit</td><td>Open an existing extension from the Extensions list. Update the required fields and select Save.</td></tr><tr><td>Delete</td><td>When delete permission is available, open the extension and select Delete. Confirm only after checking routing, phones, queues, and other references.</td></tr></tbody></table>

For PJSIP extensions, the endpoint username normally uses the extension number, a hyphen, and the tenant code, such as 101-CANISTRACCI. Press the swapped-arrow icon beside Username to switch the separator from a hyphen to an underscore, for example 101\_CANISTRACCI. If custom usernames are enabled in Admin &gt; Settings, you can enter a username that does not follow the generated tenant-code pattern.

## Information

<figure id="bkmrk-information-section-">![Information section for PJSIP extension 101.](https://manual.mirtapbx.com/uploads/images/gallery/2026-06/Y3Lpjsip-information.png)<figcaption>Information section for PJSIP extension 101.</figcaption></figure>Use this section for the extension identity, endpoint credentials, media basics, groups, voicemail message-waiting indication, DND state, and inbound ring timeout.

<table id="bkmrk-blockpurposenumber-a"><thead><tr><th>Block</th><th>Purpose</th></tr></thead><tbody><tr><td>Number and name</td><td>Number is the internal extension number. Name is the display name used in lists, caller ID, and reports.</td></tr><tr><td>Description and emergency notes</td><td>Description is an administrator note. Emergency notes can be used by emergency routing and notification logic.</td></tr><tr><td>SIP stack</td><td>Shows whether the endpoint is using chan\_sip or PJSIP. Users with switch permission can change the stack from this form or from the Extensions list.</td></tr><tr><td>Username and password</td><td>Endpoint credentials used by the phone or softphone. The default username pattern is the extension number followed by the tenant code.</td></tr><tr><td>Codecs and DTMF</td><td>Controls the allowed audio/video codecs and DTMF signaling mode used by the endpoint.</td></tr><tr><td>Media and groups</td><td>Direct media, call groups, pickup groups, spy groups, and message-waiting options control how the endpoint participates in calls and monitoring.</td></tr><tr><td>Voicemail, DND, and timeout</td><td>Voicemail MWI, DND, and inbound dial timeout control how incoming calls are presented and how long the extension rings.</td></tr></tbody></table>

## NAT Control

<figure id="bkmrk-nat-control-section-">![NAT Control section for PJSIP extension 101.](https://manual.mirtapbx.com/uploads/images/gallery/2026-06/l66pjsip-nat-control.png)<figcaption>NAT Control section for PJSIP extension 101.</figcaption></figure>Use this section to control endpoint reachability and keepalive behavior for devices behind NAT or with changing network paths.

<table id="bkmrk-blockpurposenatdefin"><thead><tr><th>Block</th><th>Purpose</th></tr></thead><tbody><tr><td>NAT</td><td>Defines how MiRTA PBX treats NAT traversal for the endpoint.</td></tr><tr><td>Qualify and qualify frequency</td><td>Controls whether the PBX checks endpoint reachability and how often checks are sent.</td></tr><tr><td>Keep alive and RTP keep alive</td><td>Sends periodic traffic to keep network mappings open and detect unavailable devices.</td></tr></tbody></table>

## Call Settings

<figure id="bkmrk-call-settings-sectio">![Call Settings section for PJSIP extension 101.](https://manual.mirtapbx.com/uploads/images/gallery/2026-06/bxHpjsip-call-settings.png)<figcaption>Call Settings section for PJSIP extension 101.</figcaption></figure>Use this section for call behavior that is not specific to inbound or outbound routing.

<table id="bkmrk-blockpurposefax-and-"><thead><tr><th>Block</th><th>Purpose</th></tr></thead><tbody><tr><td>Fax and volume</td><td>Controls T.38 fax behavior and transmit/receive volume adjustments.</td></tr><tr><td>Music on hold and language</td><td>Selects media behavior and the preferred language for prompts played to the extension.</td></tr><tr><td>Directories and phone books</td><td>Controls whether the extension appears in dial-by-name directories and phone book generated lists.</td></tr><tr><td>Call waiting and autoanswer</td><td>Controls second-call handling and optional automatic answer behavior for supported phones.</td></tr></tbody></table>

## Inbound Recording

<figure id="bkmrk-inbound-recording-se">![Inbound Recording section for PJSIP extension 101.](https://manual.mirtapbx.com/uploads/images/gallery/2026-06/fdopjsip-inbound-recording.png)<figcaption>Inbound Recording section for PJSIP extension 101.</figcaption></figure>Use this section for recording behavior applied to calls received by the extension.

<table id="bkmrk-blockpurposeinbound-"><thead><tr><th>Block</th><th>Purpose</th></tr></thead><tbody><tr><td>Inbound recording policy</td><td>Controls whether inbound calls are recorded and whether recording privacy behavior is enabled.</td></tr><tr><td>Recording notifications</td><td>When enabled, recordings can be mailed and processed according to tenant recording settings.</td></tr></tbody></table>

## Outbound Recording

<figure id="bkmrk-outbound-recording-s">![Outbound Recording section for PJSIP extension 101.](https://manual.mirtapbx.com/uploads/images/gallery/2026-06/eG1pjsip-outbound-recording.png)<figcaption>Outbound Recording section for PJSIP extension 101.</figcaption></figure>Use this section for recording and post-processing behavior applied to calls placed by the extension.

<table id="bkmrk-blockpurposealways-r"><thead><tr><th>Block</th><th>Purpose</th></tr></thead><tbody><tr><td>Always record</td><td>Controls whether outbound calls from this extension are recorded, unless tenant-wide settings force recording.</td></tr><tr><td>Email recording to</td><td>Sends matching recordings to the configured address. Minimum size can suppress very small recordings.</td></tr><tr><td>Transcript, summary, sentiment</td><td>Enables transcript, summary, and sentiment processing when the tenant supports those services.</td></tr></tbody></table>

## Security

<figure id="bkmrk-security-section-for">![Security section for PJSIP extension 101.](https://manual.mirtapbx.com/uploads/images/gallery/2026-06/0o0pjsip-security.png)<figcaption>Security section for PJSIP extension 101.</figcaption></figure>Use this section to restrict registration, authentication, abuse behavior, cost limits, and outbound availability.

<table id="bkmrk-blockpurposeauthenti"><thead><tr><th>Block</th><th>Purpose</th></tr></thead><tbody><tr><td>Authentication and network filters</td><td>Controls endpoint trust, allowed IPs, and authentication-related behavior.</td></tr><tr><td>Abuse detection and cost limits</td><td>Locks or warns on suspicious or excessive usage according to tenant policy.</td></tr><tr><td>Outbound destinations</td><td>Allows all calls, blocks calls, or applies a destination regex filter.</td></tr><tr><td>Lock PIN and max duration</td><td>Allows the extension to be locked and caps outbound call duration.</td></tr><tr><td>Working hours</td><td>Restricts outbound calling to the selected weekday condition.</td></tr></tbody></table>

## Web User Panel and Switchboard

<figure id="bkmrk-web-user-panel-and-s-1">![Web User Panel and Switchboard section for PJSIP extension 101.](https://manual.mirtapbx.com/uploads/images/gallery/2026-06/eEfpjsip-web-user-panel-and-switchboard.png)<figcaption>Web User Panel and Switchboard section for PJSIP extension 101.</figcaption></figure>Use this section to enable user-facing web access and related application permissions for the extension.

<table id="bkmrk-blockpurposeaccess-t"><thead><tr><th>Block</th><th>Purpose</th></tr></thead><tbody><tr><td>Access toggles</td><td>Enables the user panel, web phone, switchboard, and optional custom user application.</td></tr><tr><td>Web user and password</td><td>Sets the login identity and password. If no web user is specified, the endpoint username is used.</td></tr><tr><td>Password policy and 2FA</td><td>Controls expiry, forced change, lock state, LDAP use, and two-factor authentication.</td></tr><tr><td>Email, profile, and IP filter</td><td>Sets the user email, sends account information, assigns a user profile, and optionally restricts web access by IP.</td></tr></tbody></table>

## Outbound Calls

<figure id="bkmrk-outbound-calls-secti">![Outbound Calls section for PJSIP extension 101.](https://manual.mirtapbx.com/uploads/images/gallery/2026-06/ksmpjsip-outbound-calls.png)<figcaption>Outbound Calls section for PJSIP extension 101.</figcaption></figure>Use this section to control the caller ID, emergency caller ID, area-code handling, dialing filters, routing profile, and call rate used by outbound calls.

<table id="bkmrk-blockpurposeexternal"><thead><tr><th>Block</th><th>Purpose</th></tr></thead><tbody><tr><td>External caller ID</td><td>Sets or hides the caller ID number and name sent on outbound calls.</td></tr><tr><td>SMS and override caller ID</td><td>Controls SMS caller ID and optional SIP header based caller ID overrides.</td></tr><tr><td>Emergency caller ID</td><td>Defines the emergency number identity and whether empty emergency caller ID warnings are ignored.</td></tr><tr><td>Area code and caller ID regex</td><td>Applies prefixes and caller ID rewrite rules before routing.</td></tr><tr><td>Do Not and Only Allow lists</td><td>Applies tenant call-list restrictions to this extension.</td></tr><tr><td>Routing profile and call rate</td><td>Selects the routing profile, SMS routing profile, and client rate used by calls.</td></tr></tbody></table>

## Inbound Calls

<figure id="bkmrk-inbound-calls-sectio">![Inbound Calls section for PJSIP extension 101 with fictional inbound caller-list selections.](https://manual.mirtapbx.com/uploads/images/gallery/2026-06/2sWpjsip-inbound-calls.png)<figcaption>Inbound Calls section for PJSIP extension 101 with fictional inbound caller-list selections.</figcaption></figure>Use this section for inbound caller ID privacy controls and inbound caller-list filtering for calls entering from outside.

<table id="bkmrk-blockpurposeblock-in"><thead><tr><th>Block</th><th>Purpose</th></tr></thead><tbody><tr><td>Block inbound caller ID number</td><td>Prevents the caller ID number from being shown to this extension.</td></tr><tr><td>Block inbound caller ID name</td><td>Prevents the caller ID name from being shown to this extension.</td></tr><tr><td>Inbound Do Not Call lists</td><td>Allows external inbound calls from any caller ID except numbers matching the selected lists. Internal calls are always accepted.</td></tr><tr><td>Inbound Only Allow Call lists</td><td>Rejects external inbound calls unless the caller ID number matches one of the selected lists. Internal calls are always accepted.</td></tr></tbody></table>

## Find me/Follow me Configuration

<figure id="bkmrk-find-me%2Ffollow-me-co-1">![Find me/Follow me Configuration section for PJSIP extension 101.](https://manual.mirtapbx.com/uploads/images/gallery/2026-06/Gcdpjsip-find-me-follow-me-configuration.png)<figcaption>Find me/Follow me Configuration section for PJSIP extension 101.</figcaption></figure>Use this section to forward calls to an alternate number when find-me/follow-me is enabled.

<table id="bkmrk-blockpurposefmfm-num"><thead><tr><th>Block</th><th>Purpose</th></tr></thead><tbody><tr><td>FMFM number and status</td><td>Sets the external follow-me number and enables or disables the feature.</td></tr><tr><td>Condition and dial method</td><td>Limits follow-me behavior to a condition and selects how the alternate number is dialed.</td></tr><tr><td>Confirmation and messages</td><td>Requires answer confirmation and selects confirm/hold messages.</td></tr><tr><td>Caller ID and timing</td><td>Controls caller ID presentation, prefixes, delay, and dial timeout for the follow-me call.</td></tr></tbody></table>

## Additional Destinations - Active if checked

<figure id="bkmrk-additional-destinati-1">![Additional Destinations - Active if checked section for PJSIP extension 101.](https://manual.mirtapbx.com/uploads/images/gallery/2026-06/Nqkpjsip-additional-destinations-active-if-checked.png)<figcaption>Additional Destinations - Active if checked section for PJSIP extension 101.</figcaption></figure>Use this section to define failover or conditional routing for calls that do not complete normally.

<table id="bkmrk-blockpurposeuncondit"><thead><tr><th>Block</th><th>Purpose</th></tr></thead><tbody><tr><td>Unconditional</td><td>Always routes calls to the selected destination when enabled.</td></tr><tr><td>On no answer, busy, or offline</td><td>Routes calls when the extension does not answer, is busy, or is offline.</td></tr><tr><td>On condition</td><td>Routes calls to a selected destination when the chosen condition matches.</td></tr><tr><td>Missed call notification</td><td>Sends email notifications for missed calls, with options to ignore internal or queue-originated calls.</td></tr></tbody></table>

## Note

<figure id="bkmrk-note-section-for-pjs">![Note section for PJSIP extension 101.](https://manual.mirtapbx.com/uploads/images/gallery/2026-06/E6Gpjsip-note.png)<figcaption>Note section for PJSIP extension 101.</figcaption></figure>Use this section for administrative classification and free-form notes, then save or delete the extension.

<table id="bkmrk-blockpurposebranch-a"><thead><tr><th>Block</th><th>Purpose</th></tr></thead><tbody><tr><td>Branch and department</td><td>Classifies the extension for reporting and administration.</td></tr><tr><td>Reference ID and additional info</td><td>Stores external references and notes.</td></tr><tr><td>Save, delete, and back</td><td>Save applies changes, Delete removes the extension when allowed, and Back returns to the Extensions list.</td></tr></tbody></table>