Overview
On-demand activations give you control over when your ported phone numbers activate. Rather than having numbers activate automatically at a carrier-assigned time, you can trigger the activation yourself within a designated window on the FOC (Firm Order Commitment) date. This differs from scheduled activations where numbers automatically port at the exact FOC date and time assigned by the carrier. With on-demand activation, you choose the precise moment within the activation window that works best for your business operations. If you don’t initiate the activation during the window, the numbers will automatically port at the end of the window. This ensures your port order completes even if you miss the manual activation opportunity.Constraints
- On-demand activation is only available for orders where
fast_port_eligibleistrue. - Currently available for phone numbers in the US and Canada only.
- You can only initiate activation after the order reaches
foc-date-confirmedstatus. - Activation must occur within the designated activation window on the FOC date.
Activation windows
Each country has a specific window during which you can initiate on-demand activation. The window defines the earliest and latest times you can trigger the port.| Country | Window start | Window end | Duration |
|---|---|---|---|
| US | 6:00 AM CT | 8:00 PM CT | 14 hours |
| Canada | 8:00 AM CT | 3:00 PM CT | 7 hours |
foc-date-confirmed status, an activation job is created. The activation_windows array in the activation job response shows the exact start and end times for your specific order.
The activate_at field indicates when the port will occur. By default, this is set to the end of the activation window. When you initiate on-demand activation, this field updates to reflect when you triggered the request.
Activation job statuses
Each activation job has a status indicating its current state:| Status | Description |
|---|---|
created | The activation job exists and is waiting for the activation window to open. |
in-process | The activation has been initiated and numbers are being ported. |
completed | The activation finished successfully and numbers have been ported. |
How it works
Step 1: Enable on-demand activation
By default, all porting orders use scheduled activation (activation_type: scheduled). To enable on-demand activation, update the order’s activation settings using the Edit porting order endpoint.
Set activation_settings.activation_type to on-demand. The order must have fast_port_eligible set to true for this to succeed.
Step 2: View the activation window
Once your order reachesfoc-date-confirmed status, retrieve the activation job to see your activation window. Use the List porting activation jobs endpoint to view the activation_windows array containing your window’s start_at and end_at times.
Step 3: Initiate activation
When the FOC date arrives and you’re within the activation window, trigger the port using the Activate porting order endpoint. Theactivate_at field updates to reflect the time you submitted the request, and the activation process begins.
Step 4: Monitor activation progress
Track the activation job status to monitor progress. Use the List porting activation jobs endpoint or Retrieve a porting activation job endpoint to check the currentstatus.
The job progresses from created to in-process to completed. Once the status reaches completed, your numbers have finished porting and are active on your Telnyx account.
For real-time updates, configure porting notifications to receive webhooks as the activation progresses.