Messaging Port Guide (Soft Port)
This guide walks you through porting an existing number's messaging (SMS/MMS) services to Signal House. Known as a "soft port," this method allows you to keep your voice services with your current provider while Signal House handles your messaging.
Porting via Signal House Portal
Step 1: Start a New Port Request
Navigate to Numbers > Port a Number from the main dashboard, or
From a Sub Group, click the "+" icon next to Port Requests
Click "New Port Request" in the top-right corner of the page.
Step 2: Fill in the Porting Details
Business or Personal: Select the number type. If you choose "Business," enter your business name in the new field that appears.
Port Type: Select Messaging Service. This initiates a soft port.
Note: Messaging-only ports take 48 business hours, but can take up to 72 (three business days).
Account Owner Information: Enter full name and email address of the account owner. If billing contact differs, toggle "Yes" and add that info too.
Billing & Service Address Begin typing the billing address and choose from predictive results. If the service address differs, enter that as well.
Add Numbers to Port: Enter your number(s) in E.164 format (e.g.
15551234567for a US number). You can add multiple numbers by separating them with commas.
Phone Type: Choose Landline/VoIP for soft porting.
⚠️ Soft ports are not recommended for mobile numbers as voice will not carry over.
Step 3: (Optional) Advanced Settings
In the Advanced tab, assign:
Sub Group
Brand
Campaign
If you haven’t registered these yet, no problem! The number will be ported into your Company Group by default. You can assign everything later via the number configuration panel.
You can also execute this via our Porting API, which is available in our API documentation.
Step 4: Signature
Upload or draw your signature to authorize the port.
Step 5: Review Summary & Submit
Click "View Summary" to double-check your entries. Then hit "Add" to finalize the request.
Signal House will automatically generate a Letter of Authorization (LOA) to begin the process with your existing carrier.
Messaging Port via API
Use POST /phoneNumber/portNumber from Signal House’s API documentation
Required JSON Payload Fields:
{
"portingRequestType": "Business",
"businessName": "ABC Company",
"ownersName": "Jane Doe",
"ownersEmail": "jane@example.com",
"phoneNumber": "123-456-7890",
"ownersStreetAddress": "123 Main St",
"ownersExtendedAddress": "Apt 101",
"ownersCity": "Anytown",
"ownersState": "CA",
"ownersCountry": "USA",
"ownersPostalCode": "12345",
"authorizedPersonsName": "John Smith",
"serviceAddress": "456 Elm St",
"serviceExtendedAddress": "Suite 200",
"serviceCity": "Anytown",
"serviceState": "CA",
"serviceCountry": "USA",
"servicePostalCode": "12345",
"cellNumberOrLandline": "Cell",
"accountNumber": "7890123456",
"portNoAssociatedWithAcc": "Yes",
"portingService": "Entire Service",
"pinOrPasscode": "1234",
"subGroup": "SMS",
"defaultBillingGroup": "Group A",
"customerReference": "REF-001",
"activationDetailDate": "Request Date",
"comments": "Please expedite the porting process",
"brandId": "BAO84G9",
"campaignId": "C7IRUOH",
"phoneNumberToBePorted": [
"12345600121",
"15444815154",
"5454515545"
],
"groupId": "274abc5f-59f9-44e1-9deb-e829b80e4817",
"subGroupId": [
"5f37b2a3-2872-4a35-980a-548af4058e19",
"7f78d363-9e5d-4720-9a1c-96e605f625b3",
"7534c90f-fb27-4427-9148-2b52643b2ecd"
],
"signatureUrl": "65/apiuser605@example.com/profileImage/1723448994150.png"
}
You may optionally add Sub Group, Brand, and Campaign if you already have those IDs ready.
To Check Port Status:
Use GET /phoneNumber/getPortingStatusLogs
Query Parameters:
portingId(string) - The ID for the porting requestpage(number)limit(number)
If successful, you’ll see a 200 code.
Name | Description |
|---|---|
portingIdstring*(query)* | portingId to search for. |
pagenumber*(query)* | page no of porting status logs. |
limitnumber*(query)* | limit of porting status logs. |
With a sample response:
{
"page": 1,
"totalRecords": 1,
"records": [
{
"createdBy": "apiuser605@example.com",
"userID": "65",
"portingRequestType": "Personal",
"ownersName": "Signal House",
"ownersEmail": "apiuser605@example.com",
"ownersStreetAddress": "test1 update",
"ownersExtendedAddress": "test11 update",
"ownersCity": "Abbeville",
"ownersState": "AL",
"ownersCountry": "US",
"ownersPostalCode": "98908",
"authorizedPersonsName": "Test",
"phoneNumber": "+91 73501 36288",
"serviceAddress": "Nanded",
"serviceCity": "Nanded",
"serviceState": "MH",
"serviceCountry": "IN",
"servicePostalCode": "431604",
"CellNumberOrLandline": "Cell",
"accountNumber": "123456789",
"portNoAssociatedWithAcc": "Yes",
"defaultMessagingProfile": "10DLC Campaign, messaging profile, other ways we’re grouping numbers",
"defaultBillingGroup": "That way you can choose how you want to filter it",
"requestedFOCDate": "Earliest available date",
"HowToActivate": "Automatically",
"fastPort": "Yes",
"comments": "test 2",
"letterOfAuthorization": "65/apiuser605@example.com/authorizationPdf/1721705487748.octet-stream",
"portingStatus": "Complete",
"portingId": "bd3c59af-fd98-4a1a-b03b-ee2986bcc79c",
"createdDate": "2024-07-23T03:31:33.093Z",
"statusHistory": [
{
"_id": "669f2415877ee8fabc4d2923",
"status": "pending",
"date": "2024-07-23T03:31:33.093Z",
"description": "Initial status"
},
{
"status": "Inprogress",
"date": "2024-07-23T03:33:34.409Z",
"description": "your request is in progress.",
"_id": "669f248e6ee27fed015e859e"
},
{
"status": "Complete",
"date": "2024-07-23T03:33:46.750Z",
"description": "your request is completed.",
"_id": "669f249a6ee27fed015e85a2"
}
]
}
]
}
TL;DR
Go to Numbers > Port a Number
Select Messaging Service under Port Type
Only use Landline/VoIP numbers for soft ports
Add number(s), addresses, and signature
Submit via portal or API
View or track your request from the Porting dashboard
Important Notes
Soft ports do not transfer voice functionality
Signal House handles all messaging services once the port completes
Numbers can be assigned to Brands/Campaigns later
You will continue paying your current provider for voice service
Need Support?
Having trouble? Don’t worry, we’ve got your back.
📧 Email: support@signalhouse.io
💬 In-app Chat: Available inside the Signal House portal
👨💼 Account Manager: Reach out for help with large/bulk ports or stuck requests
Whether it’s a missing signature, incorrect number format, or just general "what do I do now?" confusion, we’re always happy to help.
