Before proceeding with the next steps, you need to purchase a DID on the Telnyx platform with SMS/MMS enabled.
Create a Telnyx API Key
To enable SMS/MMS sending from PortSIP PBX, you must generate a Telnyx API key.
Follow these steps on the Telnyx platform:
Sign in to your Telnyx account.
Navigate to Account Settings > Keys & Credentials.
Copy and securely store the API key.
❗Important
The API key is shown only once at creation time.
Make sure to copy and save it securely—you will need it later when configuring SMS/MMS in PortSIP PBX.
❗Security Best Practice
Treat the API key as a sensitive credential.
If the key is compromised, revoke it immediately and generate a new one.
Create an SMS Profile
To enable SMS/MMS for your Telnyx numbers, you must first create a Messaging Profile and then assign it to your purchased numbers.
Step 1: Create a Messaging Profile
Sign in to your Telnyx account.
Navigate to Messaging > Programmable Messaging.
On the profile details page:
Enter a Profile Name (for example, PortSIP PBX SMS).
Click Manage Allowed Destinations.
Select at least one destination (country or region) where you plan to send SMS.
Click Save to create the messaging profile.
❗Important
After the profile is created, copy and save the Profile ID shown on the details page.
You will need this value later when configuring SMS in PortSIP PBX.
Step 2: Assign the Messaging Profile to Phone Numbers
Navigate to Numbers > My Numbers.
Click the My Numbers tab to view your purchased phone numbers.
Locate the Messaging Profile (or Required for SMS) column.
Click the field for the desired phone number.
Select the Messaging Profile you created earlier.
Before configuring SMS in PortSIP PBX, ensure that a Telnyx SIP trunk has already been configured using one of the following guides:
Sign in to the PortSIP PBX Web Portal
You can access the tenant configuration using one of the following methods:
Option 1: Sign in as System Administrator
Sign in to the PortSIP PBX Web Portal as a System Administrator.
Select the desired tenant and click Manage to switch to that tenant’s administration context.
Option 2: Sign in as Tenant Administrator
Sign in directly as a Tenant Administrator to manage the tenant.
❗Note
For more information about tenant roles and permissions, refer to Tenant Management.
Add an SMS Configuration in PortSIP PBX
Step 1: Create the SMS Configuration
In the PortSIP PBX Web Portal, navigate to SMS/MMS from the left-hand menu.
Select your configured Telnyx trunk.
Configure the following fields:
API Key
Enter the API key created in Create Telnyx API Key.
Profile ID
Enter the Messaging Profile ID copied in the previous steps.
Click OK to save the configuration.
Step 2: Copy the PortSIP PBX SMS Webhook URL
You will be redirected to the SMS/MMS list page.
Select the SMS configuration and click Copy Webhook to copy the PortSIP PBX SMS Webhook URL.
Alternatively:
Double-click the SMS configuration to open its details page, then copy the Webhook URL from there.
❗Important
This Webhook URL is required for Telnyx to deliver inbound SMS/MMS messages to PortSIP PBX.
Step 1: Update the Messaging Profile in Telnyx
Navigate to Messaging > Programmable Messaging.
Locate the Messaging Profile created earlier.
Click the Edit (pencil) icon to edit the profile.
Paste the copied PortSIP PBX SMS Webhook URL into the field
Send a webhook to this URL.
Verify the Configuration
At this point, the Telnyx SMS/MMS integration is complete.
You can now create outbound and inbound rules in PortSIP PBX to send and receive SMS/MMS messages using the Telnyx trunk, just as you would configure rules for outbound and inbound voice calls.
