Guides / Runbook

Porting a phone number into HighLevel

A business's phone number is how its customers reach it. Moving that number into HighLevel should never leave the phones dead or the owner guessing. This is the process we follow, start to finish.

US numbers, LC PhoneChecked against HighLevel's help centre, Oct 2026
01

Before we start: the checklist

Most rejected ports fail on details that could have been confirmed on day one. We collect all of this before anything is submitted, and we confirm the name, address and account number with the current carrier, not from memory.

  • The numbers, and what type each one is. Landline, wireless, local VoIP or toll-free. Wireless numbers are handled differently.
  • The account number with the current carrier.
  • The wireless PIN, or the last four digits of the account holder's SSN where the carrier uses that. Every wireless number needs one, and a wrong PIN is an automatic rejection.
  • The authorised person's name and email. They will be emailed the Letter of Authorization to sign.
  • The service address, exactly as the carrier has it. A PO box is not accepted.
  • A recent bill from the current carrier. A clear PDF showing the numbers, the account owner's name and the carrier's name. On the manual form it must be no more than 90 days old.
  • An export of anything worth keeping. Porting moves the number only. Call recordings, voicemails and text history at the old carrier do not come across.
  • Who will submit. In HighLevel, only an agency owner or agency admin can submit a port request.
What we tell the client now: do not cancel the old phone service. The number has to stay active with the current carrier until the port is confirmed complete. Cancelling early can interrupt the transfer or make it fail.
02

Keep the business running with a temporary number

A port takes weeks, and the business needs to use HighLevel in the meantime. So before the port goes in, we set the account up with a temporary number that is ready for real use.

  • Add a new number in the sub-account to act as the temporary line.
  • Make it text-ready. Link it to the approved A2P campaign and check it shows the green "A2P Verified" label. Without that, US carriers block its texts.
  • Test it with a call and a text in both directions, from an outside phone.
  • Leave the main number where it is. It keeps working with the old carrier, so customers calling the usual number notice nothing.
  • Agree what happens to the temporary number once the port completes: keep it as a second line, or release it.
Our practice, not HighLevel's. HighLevel's porting guides don't cover temporary numbers. This step is how we make sure the business is never waiting on a carrier to get started.
03

Submit the port request

With everything confirmed, the request takes minutes.

Phone System→Phone Numbers→Add Number→Port-in Numbers
  • Complete the agreement checklist.
  • Enter the number details: carrier account number, landline numbers, wireless numbers, and the wireless PIN where required.
  • Enter the contact details: residential or business, the authorised person's name and email, and the full service address.
  • Upload the billing statement, review, and submit.
  • Save the Request SID from the confirmation screen. It is the reference for everything that follows.
  • Get the Letter of Authorization signed. HighLevel generates it from the request and emails it to the authorised person. An unsigned letter stops the port, so we follow up the same day.
Two things to know. The destination cannot be changed after submission. And the in-app flow is for US numbers: for international numbers, the route is through HighLevel Support.
04

Track it, and tell the client what to expect

Status, the Request SID and any carrier action show under Phone Numbers, in the Port-In Numbers tab. HighLevel also emails status changes. Once the losing carrier approves, it issues the date and time window for the switch.

2 to 4 weeks
HighLevel's stated timeline for fewer than 50 numbers, from the date the documents are complete.
6 to 8 weeks
For larger or more complex ports.

We don't promise a specific date until the carrier confirms one, and same-day ports are not guaranteed. The client hears from us when the date is set, and again the day before.

05

If it's rejected: the six reasons and the fix

A rejection is nearly always a mismatch between what was submitted and what the current carrier has on file. These are the reasons HighLevel documents.

Rejection reasonThe fix
Service address doesn't match carrier recordsGet the exact service address from the current carrier and use it word for word.
Incorrect account numberConfirm the account number directly with the carrier and resubmit with that exact number.
Invalid wireless PINHave the account holder confirm the PIN with the carrier.
Unsigned Letter of AuthorizationThe authorised person signs the emailed letter.
Suspended carrier accountThe account holder clears the suspension with the carrier first. A number must be active to be ported.
Invalid billing documentationUpload a recent, complete statement that clearly shows the numbers, the owner and the carrier.
A rejected request can't be edited. We read the reason in the Port-In Numbers tab, confirm the correct details with the carrier, delete the rejected request and submit a new one. The client is told the same day what was wrong and what we need from them.
06

Registration for business texting

A ported number can make and receive calls, but it can't text customers until it is covered by the right registration. We line this up while the port is in progress, so texting works on day one.

  • US local numbers need an approved A2P brand and campaign, and the ported number must be linked to that campaign.
  • Toll-free numbers don't use A2P. They go through Toll-Free Verification, and texting stays blocked until the status is Verified.
  • If the registration is rejected, the rejection code says exactly why. Our A2P rejection decoder turns each code into the fix and the message for the account owner.
07

Test everything, then close out

The port is not finished when the carrier says it is. It's finished when we've seen it work.

  • The number appears in the correct sub-account.
  • Inbound call from an unrelated outside phone.
  • Outbound call from each user or group that uses the number.
  • Inbound and outbound text, once the number shows as A2P Verified.
  • Everything that pointed at the old setup: call forwarding, assigned users, voicemail, ring groups, the phone menu, and any workflow that sends from a specific number.
  • Only then does the client cancel the old carrier.
  • Write it up: what was ported, the dates, anything that went wrong and how it was fixed.
The three client messages

What the business owner hears from us

Written for a busy owner who doesn't know what a port is and shouldn't have to. Copy them and adjust the details.

1 · Before the port
Hi [Name], We're ready to move your business number, [number], into your new system. Here's what to expect. Nothing changes for your customers today. Your number keeps working exactly as it does now while the move is being processed, which usually takes 2 to 4 weeks. Two things I need from you: 1. Please don't cancel your current phone service. If it's cancelled before the move completes, the transfer can fail. 2. You'll get an email asking you to sign a short authorisation letter. It takes a minute, and the move can't start without it. In the meantime I've set up a temporary number, [temporary number], so you can start calling and texting from your new system straight away. I'll message you as soon as your phone company confirms the switch date. [Your name]
2 · When the switch date is confirmed
Hi [Name], Your phone company has confirmed the switch: your number moves on [date], around [time window]. What to expect that day: there may be a short period, usually brief, when calls or texts to your number don't connect while the switch happens. If a call is important during that window, please use your temporary number, [temporary number]. You don't need to do anything. I'll be testing calls and texts as soon as the switch completes and will message you the moment it's confirmed working. Please keep your old service active until you hear from me. [Your name]
3 · After the port
Hi [Name], Your number, [number], is now live in your new system. I've tested it myself: - Calls in and out: working - Texts in and out: working - Voicemail and call routing: working You can now cancel your old phone service. Before you do, download anything you want to keep from them, such as old voicemails or call recordings, because those don't transfer. Your temporary number, [temporary number], is still active. Let me know if you'd like to keep it as a second line or have me remove it. If anything looks off over the next few days, reply here and I'll look at it straight away. [Your name]

Sources: HighLevel help centre articles on submitting and tracking port-in requests, the phone number migration guide, A2P campaign linking and toll-free verification, as published in October 2026. Carrier rules change, so we re-check them before each port.