How should I configure my short code messaging application during a live migration to Twilio?

Because carriers don’t all switch traffic at the same time, you’ll need to modify your application to ensure that inbound messages reach your application and outbound messages reach your end-user during the migration from one provider to another. We recommend the following process when modifying your application for a migration:

  • Your receiving system—the application that processes inbound messages from Twilio and/or the existing short code provider—must be configured to receive messages from both short code providers for the period of the migration.
  • Continue your application’s default behavior to send via the existing provider.
  • If the message fails to send, configure your application to attempt to send the message again—this time, via Twilio.
  • Update the phone number’s default message delivery to send via Twilio in your database. That way, you can default to sending via Twilio when sending any further messages to that phone number.
  • When an inbound message is received through Twilio, update that phone number’s default message delivery to send via Twilio in your database.

Once all carriers have migrated their traffic to Twilio, the Twilio Short Code Operations Team will notify you, at which point you may discontinue service with your existing provider and completely migrate all short code traffic to Twilio.

For details on how to apply to migrate your short code to Twilio, please see here.

Please email us at with any questions!