Messaging Port Guide (Soft Port)

Edited

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. 15551234567 for 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 request

  • page (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.

Was this article helpful?

Sorry about that! Care to tell us more?

Thanks for the feedback!

There was an issue submitting your feedback
Please check your connection and try again.