{"id":890,"date":"2026-10-13T09:47:22","date_gmt":"2026-10-13T09:47:22","guid":{"rendered":"https:\/\/text.email\/blog\/?p=890"},"modified":"2026-10-13T17:46:32","modified_gmt":"2026-10-13T17:46:32","slug":"number-replacements","status":"publish","type":"post","link":"https:\/\/text.email\/blog\/number-replacements\/","title":{"rendered":"New Number, Same Email Address: Number Replacements in text.email"},"content":{"rendered":"\n<p>Somewhere in your systems, an application is configured to email alerts to <code>4155550123@acme.text.email<\/code>. And that works \u2014 until the person receiving those alerts changes their number, leaves the team, or hands that responsibility to someone else.<\/p>\n\n\n\n<p>That is why we built <strong>number replacements in text.email<\/strong>. You can redirect messages from an old number to a new number or a distribution list, without tracking down and updating every application that uses the original number.<\/p>\n\n\n\n<p>The replacement receives the message; the old number doesn&#8217;t receive a copy.<\/p>\n\n\n\n<p>Here is how to set up a replacement, manage your saved rules, and understand what happens when messages arrive through email or the API.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">How to Set Up a Number Replacement in text.email<\/h2>\n\n\n\n<p>It&#8217;s a quick process to create a replacement&#8230;<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">1. Open Number replacements in Settings<\/h3>\n\n\n\n<p>Sign in to text.email, open <strong>Settings<\/strong>, and find <strong>Number replacements<\/strong>.<\/p>\n\n\n\n<figure data-wp-context=\"{&quot;imageId&quot;:&quot;6afcb3df5d76f&quot;}\" data-wp-interactive=\"core\/image\" data-wp-key=\"6afcb3df5d76f\" class=\"wp-block-image size-large wp-lightbox-container\"><img loading=\"lazy\" decoding=\"async\" width=\"1024\" height=\"630\" data-wp-class--hide=\"state.isContentHidden\" data-wp-class--show=\"state.isContentVisible\" data-wp-init=\"callbacks.setButtonStyles\" data-wp-on--click=\"actions.showLightbox\" data-wp-on--load=\"callbacks.setButtonStyles\" data-wp-on-window--resize=\"callbacks.setButtonStyles\" src=\"https:\/\/text.email\/blog\/wp-content\/uploads\/2026\/10\/numberreplacement-settings-tinified-1024x630.png\" alt=\"\" class=\"wp-image-895\" srcset=\"https:\/\/text.email\/blog\/wp-content\/uploads\/2026\/10\/numberreplacement-settings-tinified-1024x630.png 1024w, https:\/\/text.email\/blog\/wp-content\/uploads\/2026\/10\/numberreplacement-settings-tinified-300x184.png 300w, https:\/\/text.email\/blog\/wp-content\/uploads\/2026\/10\/numberreplacement-settings-tinified-768x472.png 768w, https:\/\/text.email\/blog\/wp-content\/uploads\/2026\/10\/numberreplacement-settings-tinified-1536x944.png 1536w, https:\/\/text.email\/blog\/wp-content\/uploads\/2026\/10\/numberreplacement-settings-tinified.png 2004w\" sizes=\"auto, (max-width: 1024px) 100vw, 1024px\" \/><button\n\t\t\tclass=\"lightbox-trigger\"\n\t\t\ttype=\"button\"\n\t\t\taria-haspopup=\"dialog\"\n\t\t\taria-label=\"Enlarge\"\n\t\t\tdata-wp-init=\"callbacks.initTriggerButton\"\n\t\t\tdata-wp-on--click=\"actions.showLightbox\"\n\t\t\tdata-wp-style--right=\"state.imageButtonRight\"\n\t\t\tdata-wp-style--top=\"state.imageButtonTop\"\n\t\t>\n\t\t\t<svg xmlns=\"http:\/\/www.w3.org\/2000\/svg\" width=\"12\" height=\"12\" fill=\"none\" viewBox=\"0 0 12 12\">\n\t\t\t\t<path fill=\"#fff\" d=\"M2 0a2 2 0 0 0-2 2v2h1.5V2a.5.5 0 0 1 .5-.5h2V0H2Zm2 10.5H2a.5.5 0 0 1-.5-.5V8H0v2a2 2 0 0 0 2 2h2v-1.5ZM8 12v-1.5h2a.5.5 0 0 0 .5-.5V8H12v2a2 2 0 0 1-2 2H8Zm2-12a2 2 0 0 1 2 2v2h-1.5V2a.5.5 0 0 0-.5-.5H8V0h2Z\" \/>\n\t\t\t<\/svg>\n\t\t<\/button><\/figure>\n\n\n\n<p>The <strong>Add a replacement<\/strong> form is where you connect the number your systems already use to the destination you want going forward.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">2. Enter the old phone number<\/h3>\n\n\n\n<p>In <strong>Old number<\/strong>, enter the phone number currently used by your email or API integration.<\/p>\n\n\n\n<p>For example, if a monitoring tool sends alerts to <code>4155550123@acme.text.email<\/code>, enter <code>4155550123<\/code>. You can also use the country-code format: <code>+14155550123<\/code>.<\/p>\n\n\n\n<p>You&#8217;re entering just the phone number here, not the full email address. (Ten-digit numbers are treated as U.S. or Canadian numbers.)<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">3. Choose a new number or a distribution list<\/h3>\n\n\n\n<p>Each old number can point to one replacement destination:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>A new phone number.<\/strong> Enter it in <strong>New number<\/strong> and leave the distribution-list selection set to <strong>Use new number<\/strong>.<\/li>\n\n\n\n<li><strong>A <a href=\"https:\/\/text.email\/blog\/distribution-lists\/\" data-type=\"post\" data-id=\"296\">distribution list<\/a>.<\/strong> Choose one of your existing lists and leave <strong>New number<\/strong> blank.<\/li>\n<\/ul>\n\n\n\n<p>If you only want one phone to be the replacement, the use the &#8220;new phone number option.&#8221;<\/p>\n\n\n\n<p> If those alerts now belong to a team (or should), choose a distribution list such as \u201cOn-call team.&#8221;<\/p>\n\n\n\n<figure class=\"wp-block-image size-large\"><img loading=\"lazy\" decoding=\"async\" width=\"1024\" height=\"640\" src=\"https:\/\/text.email\/blog\/wp-content\/uploads\/2026\/10\/numberreplacement-distlist-tinified-1024x640.png\" alt=\"\" class=\"wp-image-896\" srcset=\"https:\/\/text.email\/blog\/wp-content\/uploads\/2026\/10\/numberreplacement-distlist-tinified-1024x640.png 1024w, https:\/\/text.email\/blog\/wp-content\/uploads\/2026\/10\/numberreplacement-distlist-tinified-300x187.png 300w, https:\/\/text.email\/blog\/wp-content\/uploads\/2026\/10\/numberreplacement-distlist-tinified-768x480.png 768w, https:\/\/text.email\/blog\/wp-content\/uploads\/2026\/10\/numberreplacement-distlist-tinified-1536x960.png 1536w, https:\/\/text.email\/blog\/wp-content\/uploads\/2026\/10\/numberreplacement-distlist-tinified.png 2004w\" sizes=\"auto, (max-width: 1024px) 100vw, 1024px\" \/><\/figure>\n\n\n\n<h3 class=\"wp-block-heading\">4. Save the replacement and send a test message<\/h3>\n\n\n\n<p>Click <strong>Save replacement<\/strong>. Your rule appears in the table of existing replacements.<\/p>\n\n\n\n<p>Now send a test message through the integration you&#8217;re already using, still addressed to the old number. For example, with this rule:<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>Old number:  +14155550123\nNew number:  +14155550198<\/code><\/pre>\n\n\n\n<p>An email to <code>4155550123@acme.text.email<\/code> produces a text addressed to <code>4155550198<\/code>. Again, your sending application keeps its existing configuration.<\/p>\n\n\n\n<p>If you selected a distribution list, check that the intended members receive the test. Their sending settings and schedules still apply.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">How number replacements work with email and API requests<\/h3>\n\n\n\n<p>A replacement changes the destination when text.email processes an incoming message.<\/p>\n\n\n\n<p>So API requests work (at least conceptually) the same as the email-to-text approach we just covered. Your application can keep sending the old number in the <code>to<\/code> field in its API requests.<\/p>\n\n\n\n<p>For example, again, if you&#8217;re replacing <code>4155550123<\/code> with <code>4155550198<\/code>,  then this API call&#8230;<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>{\n  \"to\": \"+14155550123\",\n  \"text\": \"The overnight backup has completed.\"\n}<\/code><\/pre>\n\n\n\n<p>&#8230;would send to <code>4155550198<\/code> automatically.<\/p>\n\n\n\n<p>text.email uses your saved replacement to determine the final destination before sending.<\/p>\n\n\n\n<p>Rules belong to your account: another account can have a different replacement for the same number. Trial API requests do not use your rules, even if they supply your email address as the sender.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">How to edit or remove a saved number replacement<\/h3>\n\n\n\n<p>The replacement table shows each <strong>Old number<\/strong>, its <strong>Replace with<\/strong> destination, and <strong>Edit<\/strong> and <strong>Remove<\/strong> actions. The &#8220;Replace with&#8221; has a label (phone numbers or distribution lists), so you can review your rules at a glance.<\/p>\n\n\n\n<p>Click <strong>Edit<\/strong> to open the form.<\/p>\n\n\n\n<figure data-wp-context=\"{&quot;imageId&quot;:&quot;6afcb3df5f173&quot;}\" data-wp-interactive=\"core\/image\" data-wp-key=\"6afcb3df5f173\" class=\"wp-block-image size-large wp-lightbox-container\"><img loading=\"lazy\" decoding=\"async\" width=\"1024\" height=\"751\" data-wp-class--hide=\"state.isContentHidden\" data-wp-class--show=\"state.isContentVisible\" data-wp-init=\"callbacks.setButtonStyles\" data-wp-on--click=\"actions.showLightbox\" data-wp-on--load=\"callbacks.setButtonStyles\" data-wp-on-window--resize=\"callbacks.setButtonStyles\" src=\"https:\/\/text.email\/blog\/wp-content\/uploads\/2026\/10\/numberreplacement-edit-tinified-1024x751.png\" alt=\"\" class=\"wp-image-897\" srcset=\"https:\/\/text.email\/blog\/wp-content\/uploads\/2026\/10\/numberreplacement-edit-tinified-1024x751.png 1024w, https:\/\/text.email\/blog\/wp-content\/uploads\/2026\/10\/numberreplacement-edit-tinified-300x220.png 300w, https:\/\/text.email\/blog\/wp-content\/uploads\/2026\/10\/numberreplacement-edit-tinified-768x563.png 768w, https:\/\/text.email\/blog\/wp-content\/uploads\/2026\/10\/numberreplacement-edit-tinified-1536x1127.png 1536w, https:\/\/text.email\/blog\/wp-content\/uploads\/2026\/10\/numberreplacement-edit-tinified.png 2004w\" sizes=\"auto, (max-width: 1024px) 100vw, 1024px\" \/><button\n\t\t\tclass=\"lightbox-trigger\"\n\t\t\ttype=\"button\"\n\t\t\taria-haspopup=\"dialog\"\n\t\t\taria-label=\"Enlarge\"\n\t\t\tdata-wp-init=\"callbacks.initTriggerButton\"\n\t\t\tdata-wp-on--click=\"actions.showLightbox\"\n\t\t\tdata-wp-style--right=\"state.imageButtonRight\"\n\t\t\tdata-wp-style--top=\"state.imageButtonTop\"\n\t\t>\n\t\t\t<svg xmlns=\"http:\/\/www.w3.org\/2000\/svg\" width=\"12\" height=\"12\" fill=\"none\" viewBox=\"0 0 12 12\">\n\t\t\t\t<path fill=\"#fff\" d=\"M2 0a2 2 0 0 0-2 2v2h1.5V2a.5.5 0 0 1 .5-.5h2V0H2Zm2 10.5H2a.5.5 0 0 1-.5-.5V8H0v2a2 2 0 0 0 2 2h2v-1.5ZM8 12v-1.5h2a.5.5 0 0 0 .5-.5V8H12v2a2 2 0 0 1-2 2H8Zm2-12a2 2 0 0 1 2 2v2h-1.5V2a.5.5 0 0 0-.5-.5H8V0h2Z\" \/>\n\t\t\t<\/svg>\n\t\t<\/button><\/figure>\n\n\n\n<p>Change its destination and click <strong>Save changes<\/strong>.<\/p>\n\n\n\n<p><strong>Remove<\/strong> deletes the replacement rule. Future messages then follow normal routing to the original number. If you need to delete a distribution list used by a replacement, first remove that rule or point it somewhere else.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Number Replacement Limits and Delivery Behavior<\/h2>\n\n\n\n<p>Ok, now that we have the basics down, here&#8217;s the nuance.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">How distribution lists behave with number replacements<\/h3>\n\n\n\n<p>When a replacement points to a distribution list, text.email checks that list\u2019s membership when processing the message. So you can maintain the team\u2019s recipients in the list without changing the replacement rule.<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>Disabled members are excluded.<\/strong> A replacement does not override a member\u2019s sending setting.<\/li>\n\n\n\n<li><strong><a href=\"https:\/\/text.email\/blog\/scheduled-sms-routing\/\" data-type=\"post\" data-id=\"632\">Member schedules<\/a> still apply.<\/strong> Scheduled members receive messages according to their configured availability.<\/li>\n\n\n\n<li><strong>Duplicate numbers are consolidated.<\/strong> Repeated entries in the replacement list do not create extra copies for that number.<\/li>\n\n\n\n<li><strong>The old number stays excluded.<\/strong> Even if it remains a member of its replacement list, it does not receive the redirected message. (In other words, it won&#8217;t create an endless loop of sending because the replaced number is in the list.)<\/li>\n<\/ul>\n\n\n\n<p>If there are no eligible recipients on the distribution list, nothing is sent for that replacement. text.email does not fall back to the old number. The API returns a <code>no_recipients<\/code> error in this situation.<\/p>\n\n\n\n<p>Rules also apply to numbers found in a list addressed by email. If an existing list contains an old number with a replacement rule, text.email resolves that number before sending. In other words, if someone who used to be <code>6172453232<\/code> is on the list and you replaced their number with <code>6178292012<\/code>, then text.email will know to send to <code>6178292012<\/code>.<\/p>\n\n\n\n<p>Your saved list membership is not rewritten, so removing the rule restores the original routing.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Replacement rules apply once per incoming number<\/h3>\n\n\n\n<p>Suppose number A points to B, and B has its own rule pointing to C. A message originally addressed to A goes to B. It does not continue through B\u2019s rule to C.<\/p>\n\n\n\n<p>This prevents rules from creating loops. To send A\u2019s messages to C, update A\u2019s destination directly.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Sending limits count the final recipients<\/h3>\n\n\n\n<p>Normal account limits still apply. A two-part SMS sent to three recipients uses six message units. API replacements are subject to a maximum of 100 message units per request.<\/p>\n\n\n\n<p>SMS and MMS replacement destinations must be U.S. or Canadian numbers. Replacements also work with configured iMessage routes, which support international numbers.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Message history and API retry protection follow the send<\/h3>\n\n\n\n<p>Message logs record the resolved recipients, so you can see the actual destinations.<\/p>\n\n\n\n<p>For API integrations, retrying an already accepted request with the same idempotency key does not create another send, even if you have since changed the replacement rule. Use a new idempotency key when sending a new message.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Need to Replace a Number for a text.email Alert?<\/h2>\n\n\n\n<p>A changed phone number shouldn&#8217;t mean hunting through every application that sends an alert.<\/p>\n\n\n\n<p>Number replacements in text.email give you <strong>one place to update the destination<\/strong>, whether those messages now belong to a different phone or an entire team.<\/p>\n\n\n\n<p>Open <strong>Settings > Number replacements<\/strong>, add your rule, and you&#8217;re all set.<\/p>\n\n\n\n<p>Want to give text.email a try? You don&#8217;t need to sign up in advance \u2014 just send a sample alert email to <code>your-number@text.email<\/code> and watch it come through to your phone as a text.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>Replace a number in text.email with a new number or list \u2014 no need to update every application that uses the original number.<\/p>\n","protected":false},"author":1,"featured_media":900,"comment_status":"closed","ping_status":"","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[3,8],"tags":[],"class_list":["post-890","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-email-to-sms","category-text-email-tips"],"_links":{"self":[{"href":"https:\/\/text.email\/blog\/wp-json\/wp\/v2\/posts\/890","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/text.email\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/text.email\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/text.email\/blog\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/text.email\/blog\/wp-json\/wp\/v2\/comments?post=890"}],"version-history":[{"count":4,"href":"https:\/\/text.email\/blog\/wp-json\/wp\/v2\/posts\/890\/revisions"}],"predecessor-version":[{"id":894,"href":"https:\/\/text.email\/blog\/wp-json\/wp\/v2\/posts\/890\/revisions\/894"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/text.email\/blog\/wp-json\/wp\/v2\/media\/900"}],"wp:attachment":[{"href":"https:\/\/text.email\/blog\/wp-json\/wp\/v2\/media?parent=890"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/text.email\/blog\/wp-json\/wp\/v2\/categories?post=890"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/text.email\/blog\/wp-json\/wp\/v2\/tags?post=890"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}