Porting into HoopAI
Gather your information
Before starting, collect:
- The phone number(s) you want to port
- Your current carrier name
- Your account number with the current carrier
- The account PIN or password
- The authorized user’s name on the account
- A recent bill or Letter of Authorization (LOA)
Submit a port request
Go to Settings > Phone System > Phone Numbers and click Port Number. Fill in the required information and upload your LOA.
Sign the Letter of Authorization
The LOA authorizes the transfer of your number. Sign the document and ensure all details match your current carrier’s records exactly — any discrepancy will cause a rejection.
Wait for carrier processing
The porting process takes 2-4 weeks on average. During this time:
- Your number remains active on your current carrier
- You will receive status updates via email
- A firm port date (FOC date) will be assigned by the carriers
Porting out of HoopAI
If you need to transfer a number away from the HoopAI platform:- Contact support and request a port-out
- Provide the receiving carrier’s information
- The support team will provide your account details and authorize the transfer
- The receiving carrier processes the port (timeline varies)
International number porting
International porting is supported for select countries. Requirements and timelines vary significantly by country. Contact support with the specific number and destination country to confirm availability and get an estimated timeline.Porting between sub-accounts
If you manage multiple sub-accounts in the HoopAI platform, you can transfer phone numbers between them without going through the full external porting process:- Contact support with the number and the source and destination sub-accounts
- The transfer is processed internally, typically within 1-2 business days
- Call routing and SMS settings are reset on the destination account — reconfigure them after transfer
Common porting failures and fixes
| Issue | Cause | Fix |
|---|---|---|
| Name mismatch | The name on the LOA does not match the carrier’s records | Use the exact name as it appears on your carrier account |
| Account number wrong | Incorrect account number submitted | Verify with your current carrier |
| PIN/password incorrect | Wrong account PIN | Contact your current carrier to confirm or reset your PIN |
| Number already porting | Another port request is in progress | Wait for the existing request to complete or cancel it |
| Carrier rejection | The losing carrier rejected the request | Contact the losing carrier for the specific rejection reason and resubmit |
| Partial port | Only some numbers in a multi-number request were approved | Resubmit the rejected numbers with corrected information |
Timeline expectations
| Stage | Timeline |
|---|---|
| Port request submission | Same day |
| Carrier acknowledgment | 1-3 business days |
| FOC date assigned | 3-7 business days after acknowledgment |
| Port execution | On the FOC date (typically 2-4 weeks from submission) |
| Post-port verification | Same day as execution |
Wireless-to-wireless ports tend to be faster (1-2 weeks). Landline and toll-free ports can take 3-4 weeks. International ports may take 4-8 weeks depending on the country.
Frequently asked questions
Will there be any downtime during the port?
Will there be any downtime during the port?
There may be a brief period (minutes to a few hours) during the port execution when calls may not route correctly. This is normal and resolves once the port is fully complete.
Can I port toll-free numbers?
Can I port toll-free numbers?
Yes. Toll-free numbers (800, 888, 877, etc.) can be ported into the platform. The process is similar but may take slightly longer.
What if my current carrier charges an early termination fee?
What if my current carrier charges an early termination fee?
Porting a number may trigger early termination fees from your current carrier depending on your contract. Check with your carrier before initiating the port.
Can I port multiple numbers at once?
Can I port multiple numbers at once?
Yes. You can submit a batch port request for multiple numbers from the same carrier and account. All numbers will be processed together.