Campaign Migration

Migrate an active 10DLC campaign and its numbers to Telgorithm, covering port-in and the TCR CNP migration.

Important: To enable Campaign Migration, please reach out to our team at support@telgorithm.com. We typically respond within 1 business day to confirm it's enabled.

Process at a Glance

Step What Happens

1. Create MessagingConfig & Port-in Numbers Create a MessagingConfig first. Pro-tip: Include the TCR Campaign ID in the MessagingConfig name for automatic linking later. Then submit a port-in request with numbers attached to it, along with LOA paperwork.

2. Initiate Migration in TCR & Configure the Imported Campaign In the TCR CSP Portal or via the TCR API, select Telgorithm Inc as the new CNP for the active campaign. Once the campaign appears in Telgorithm and the TcrCampaignImported webhook is received, it becomes available for configuration. At this point, the previously created MessagingConfig must be linked to the imported campaign (this happens automatically if you include the Campaign ID in its name). Once attached, the associated numbers automatically transition to Active.

Step	What Happens
1. Create MessagingConfig & Port-in Numbers	Create a `MessagingConfig` first. Pro-tip: Include the TCR Campaign ID in the `MessagingConfig` name for automatic linking later. Then submit a port-in request with numbers attached to it, along with LOA paperwork.
2. Initiate Migration in TCR & Configure the Imported Campaign	In the TCR CSP Portal or via the TCR API, select Telgorithm Inc as the new CNP for the active campaign. Once the campaign appears in Telgorithm and the `TcrCampaignImported` webhook is received, it becomes available for configuration. At this point, the previously created `MessagingConfig` must be linked to the imported campaign (this happens automatically if you include the Campaign ID in its name). Once attached, the associated numbers automatically transition to `Active`.

Interaction Flow

Campaign Migration diagram

Port-in Numbers

Port-in requests can be submitted before the campaign migration.

⏱ Timing: The process typically takes ~1-2 days, but may take longer. All messaging continues to flow through your previous CNP during porting.

Full request details: POST /v1/Phones/port-in

Note for 10DLC traffic: Under normal conditions, calling POST /v1/Phones/port-in without specifying a MessagingConfig that is linked to an active TCR campaign will result in an error.

However, if Campaign Migration is enabled on the account, this validation is temporarily bypassed: numbers can be ported with a MessagingConfig that isn’t linked to a campaign yet. Once the campaign is migrated and the TcrCampaignImported webhook is received, link the MessagingConfig (automatically or manually) to the campaign to activate the numbers.

After you submit POST /v1/Phones/port-in, Telgorithm begins sending phoneNumberStatusChanged webhooks as the order progresses. The first status is PendingPortIn, which arrives immediately and confirms that Telgorithm has accepted the port-in order. No action is required at this point. When numbers are successfully ported in, the status becomes PendingTcrCampaignAdd. They remain in this status until you complete the campaign migration in TCR and attach the MessagingConfig to the imported campaign.

Initiate CNP Migration in TCR

Once the numbers have been ported in, the final step is to migrate the active campaign from the previous Connectivity Partner (CNP) to Telgorithm.

This action is performed in TCR. Once complete, the campaign becomes fully managed by Telgorithm, and you can attach a MessagingConfig to it.

⏱ Timing: The migration typically takes a few minutes to be fully accepted by all downstream carriers and Telgorithm.

There are two ways to trigger the migration:

Using the TCR CSP Portal

Log in to the TCR CSP Portal.
Open the campaign you wish to migrate.
Click Initiate Migration.
Select Telgorithm Inc as the new CNP.
Submit the request.

Using the TCR API

https://csp-api.campaignregistry.com/v2/campaign/{campaignId}/migrateCnp/SQTIJSW

Replace {campaignId} with the campaign you want to migrate.
Use SQTIJSW as Telgorithm’s upstream CNP ID.

When the migration is completed, the campaign will appear in your Telgorithm account and the TcrCampaignImported webhook will be triggered.

Activation After Campaign Migration

Once the campaign migration in TCR is approved and the campaign appears in your Telgorithm account, you will receive a TcrCampaignImported webhook. To complete activation, attach your existing MessagingConfig to the newly imported TCR campaign and ensure the phone numbers are linked to that MessagingConfig.

There are two ways this linking occurs:

Automatic Linking (Recommended)

To avoid manual steps and start sending traffic as fast as possible, simply include the exact TCR Campaign ID anywhere in the name of your unlinked MessagingConfig before the migration completes. When Telgorithm receives the campaign webhook, the system will search for this exact ID among your unlinked MessagingConfigs. If exactly one match is found, it will automatically link the campaign and the MessagingConfig for you.

Manual Linking (Fallback)

If you choose not to include the Campaign ID in the name, or if the system detects multiple unlinked MessagingConfigs containing the same ID (to prevent conflicts), no automatic linking will occur. In this case, you must manually attach your existing MessagingConfig to the imported TCR campaign via the API or Portal.

When both associations exist, each number’s status transitions to Active (this typically takes 5-10 minutes). Once a number is Active, outbound traffic can flow. If a number is linked to a MessagingConfig that is not connected to a campaign, it will remain in PendingTcrCampaignAdd status.

Cutover & Traffic Flow (step-by-step)

You submit the port-in request
- Inbound: flows via the previous CNP.
- Outbound: flows via the previous CNP.
- Timing: port-in processing typically 1–2 days (you'll receive PhoneNumberStatusChanged webhooks).
Port completes
- Inbound: flows via Telgorithm immediately after port completion.
- Outbound: paused — messages cannot be sent while the number is not in Active status.
- Timing: numbers remain in PendingTcrCampaignAdd until you complete the migration.
Migrate and Attach the Campaign
- Inbound: flows via Telgorithm.
- Outbound: flows via Telgorithm.
- Timing: TCR migration is usually accepted within a few minutes; numbers typically become Active within 5–10 minutes after you link the campaign and phone numbers.

Overall cutover: By utilizing the automatic linking feature, you can eliminate manual steps. Expect a 5–10 minute outbound outage while numbers transition to Active; inbound traffic is not interrupted.