Send SMS and MMS messages

• Install Python.
• Install the Twilio Python module. To install using pip, run:
  Copy code block

  pip install twilio

• Sign up for Twilio and get a phone number:

  1. Sign up for Twilio.

  2. On the Twilio Console landing page:

     1. To acquire a phone number, click Get phone number.
     2. Copy your Account SID and Auth Token and paste them in a temporary local file for use later in this tutorial.

  3. Complete any applicable verification or registration requirements.

     • Toll-free numbers: Complete toll-free verification to send SMS messages to recipients in the US and Canada.
     • US 10DLC numbers: Register for A2P 10DLC to send SMS messages to recipients in the US. To learn more, see What is A2P 10DLC?.
     • UK long code numbers: Submit a Regulatory Compliance (RC) bundle to send SMS messages to recipients in the UK. To learn more, see Know Your Customer (KYC) in the United Kingdom.

• Install Node.js.
• Install the Twilio Node.js helper library:
  Copy code block

  npm install twilio

• Sign up for Twilio and get a phone number:

  1. Sign up for Twilio.

  2. On the Twilio Console landing page:

     1. To acquire a phone number, click Get phone number.
     2. Copy your Account SID and Auth Token and paste them in a temporary local file for use later in this tutorial.

  3. Complete any applicable verification or registration requirements.

     • Toll-free numbers: Complete toll-free verification to send SMS messages to recipients in the US and Canada.
     • US 10DLC numbers: Register for A2P 10DLC to send SMS messages to recipients in the US. To learn more, see What is A2P 10DLC?.
     • UK long code numbers: Submit a Regulatory Compliance (RC) bundle to send SMS messages to recipients in the UK. To learn more, see Know Your Customer (KYC) in the United Kingdom.

• Install PHP.
• Install dependencies with Composer:
  1. Install Composer.
  2. Install the Twilio PHP helper library:
     Copy code block

     1
     composer require twilio/sdk
     2
     composer install

• Sign up for Twilio and get a phone number:

  1. Sign up for Twilio.

  2. On the Twilio Console landing page:

     1. To acquire a phone number, click Get phone number.
     2. Copy your Account SID and Auth Token and paste them in a temporary local file for use later in this tutorial.

  3. Complete any applicable verification or registration requirements.

     • Toll-free numbers: Complete toll-free verification to send SMS messages to recipients in the US and Canada.
     • US 10DLC numbers: Register for A2P 10DLC to send SMS messages to recipients in the US. To learn more, see What is A2P 10DLC?.
     • UK long code numbers: Submit a Regulatory Compliance (RC) bundle to send SMS messages to recipients in the UK. To learn more, see Know Your Customer (KYC) in the United Kingdom.

• Download Visual Studio 2019 or later.

• Sign up for Twilio and get a phone number:

  1. Sign up for Twilio.

  2. On the Twilio Console landing page:

     1. To acquire a phone number, click Get phone number.
     2. Copy your Account SID and Auth Token and paste them in a temporary local file for use later in this tutorial.

  3. Complete any applicable verification or registration requirements.

     • Toll-free numbers: Complete toll-free verification to send SMS messages to recipients in the US and Canada.
     • US 10DLC numbers: Register for A2P 10DLC to send SMS messages to recipients in the US. To learn more, see What is A2P 10DLC?.
     • UK long code numbers: Submit a Regulatory Compliance (RC) bundle to send SMS messages to recipients in the UK. To learn more, see Know Your Customer (KYC) in the United Kingdom.

• Install .NET Core.

• Sign up for Twilio and get a phone number:

  1. Sign up for Twilio.

  2. On the Twilio Console landing page:

     1. To acquire a phone number, click Get phone number.
     2. Copy your Account SID and Auth Token and paste them in a temporary local file for use later in this tutorial.

  3. Complete any applicable verification or registration requirements.

     • Toll-free numbers: Complete toll-free verification to send SMS messages to recipients in the US and Canada.
     • US 10DLC numbers: Register for A2P 10DLC to send SMS messages to recipients in the US. To learn more, see What is A2P 10DLC?.
     • UK long code numbers: Submit a Regulatory Compliance (RC) bundle to send SMS messages to recipients in the UK. To learn more, see Know Your Customer (KYC) in the United Kingdom.

• Install Java Standard Edition (SE) Development Kit.
• Download the Twilio Java Helper library fat jar file with all dependencies:
  1. Navigate to the Maven repository.
  2. Click the most recent version number.
  3. In the Files row, click View All.
  4. Click the file ending in jar-with-dependencies.jar.

• Sign up for Twilio and get a phone number:

  1. Sign up for Twilio.

  2. On the Twilio Console landing page:

     1. To acquire a phone number, click Get phone number.
     2. Copy your Account SID and Auth Token and paste them in a temporary local file for use later in this tutorial.

  3. Complete any applicable verification or registration requirements.

     • Toll-free numbers: Complete toll-free verification to send SMS messages to recipients in the US and Canada.
     • US 10DLC numbers: Register for A2P 10DLC to send SMS messages to recipients in the US. To learn more, see What is A2P 10DLC?.
     • UK long code numbers: Submit a Regulatory Compliance (RC) bundle to send SMS messages to recipients in the UK. To learn more, see Know Your Customer (KYC) in the United Kingdom.

• Install Go.

• Sign up for Twilio and get a phone number:

  1. Sign up for Twilio.

  2. On the Twilio Console landing page:

     1. To acquire a phone number, click Get phone number.
     2. Copy your Account SID and Auth Token and paste them in a temporary local file for use later in this tutorial.

  3. Complete any applicable verification or registration requirements.

     • Toll-free numbers: Complete toll-free verification to send SMS messages to recipients in the US and Canada.
     • US 10DLC numbers: Register for A2P 10DLC to send SMS messages to recipients in the US. To learn more, see What is A2P 10DLC?.
     • UK long code numbers: Submit a Regulatory Compliance (RC) bundle to send SMS messages to recipients in the UK. To learn more, see Know Your Customer (KYC) in the United Kingdom.

• Install Ruby.
• Install the Twilio Ruby helper library:
  Copy code block

  gem install twilio-ruby

• Sign up for Twilio and get a phone number:

  1. Sign up for Twilio.

  2. On the Twilio Console landing page:

     1. To acquire a phone number, click Get phone number.
     2. Copy your Account SID and Auth Token and paste them in a temporary local file for use later in this tutorial.

  3. Complete any applicable verification or registration requirements.

     • Toll-free numbers: Complete toll-free verification to send SMS messages to recipients in the US and Canada.
     • US 10DLC numbers: Register for A2P 10DLC to send SMS messages to recipients in the US. To learn more, see What is A2P 10DLC?.
     • UK long code numbers: Submit a Regulatory Compliance (RC) bundle to send SMS messages to recipients in the UK. To learn more, see Know Your Customer (KYC) in the United Kingdom.

• Install cURL.

  Most macOS and Linux machines come with cURL preinstalled.

• Sign up for Twilio and get a phone number:

  1. Sign up for Twilio.

  2. On the Twilio Console landing page:

     1. To acquire a phone number, click Get phone number.
     2. Copy your Account SID and Auth Token and paste them in a temporary local file for use later in this tutorial.

  3. Complete any applicable verification or registration requirements.

     • Toll-free numbers: Complete toll-free verification to send SMS messages to recipients in the US and Canada.
     • US 10DLC numbers: Register for A2P 10DLC to send SMS messages to recipients in the US. To learn more, see What is A2P 10DLC?.
     • UK long code numbers: Submit a Regulatory Compliance (RC) bundle to send SMS messages to recipients in the UK. To learn more, see Know Your Customer (KYC) in the United Kingdom.

1. Create and open a new file called send_message.py anywhere on your machine and paste in the following code:

   Send an SMS Using Twilio with Python

   Report code block

   Copy code block

   1
   # Download the helper library from https://www.twilio.com/docs/python/install
   2
   import os
   3
   from twilio.rest import Client
   4
   
   5
   # Find your Account SID and Auth Token at twilio.com/console
   6
   # and set the environment variables. See http://twil.io/secure
   7
   account_sid = os.environ["TWILIO_ACCOUNT_SID"]
   8
   auth_token = os.environ["TWILIO_AUTH_TOKEN"]
   9
   client = Client(account_sid, auth_token)
   10
   
   11
   message = client.messages.create(
   12
       body="Join Earth's mightiest heroes. Like Kevin Bacon.",
   13
       from_="+15017122661",
   14
       to="+15558675310",
   15
   )
   16
   
   17
   print(message.body)

   To learn all of the API response values that you can return with print(), see the response for Send an SMS Message in the API documentation. Precede the response value with message. (for example: print(message.status) returns the status value).

2. Set the environment variables for your Account SID and Auth Token.

   (warning)

   Improve security with API keys

   To better control access, use API keys instead of the Account SID and Auth Token when you deploy to production. To learn more, see Why you should use API keys.

   On Mac or Linux:

   1. Run the following commands to add your credentials as environment variables in a twilio.env file and source them. Replace ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX with your Account SID and replace your_auth_token with your Auth Token.

      Copy code block

      1
      echo "export TWILIO_ACCOUNT_SID='ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX'" > twilio.env
      2
      echo "export TWILIO_AUTH_TOKEN='your_auth_token'" >> twilio.env
      3
      source ./twilio.env

   2. If you're committing code with git, run the following command to add the twilio.env file to .gitignore to avoid uploading your credentials in plain text:

      Copy code block

      echo "twilio.env" >> .gitignore

   On Windows command line (cmd.exe), run the following commands. Replace ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX with your Account SID and replace your_auth_token with your Auth Token.

   Copy code block

   1
   set TWILIO_ACCOUNT_SID=ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
   2
   set TWILIO_AUTH_TOKEN=your_auth_token

   To learn more, see Store your Twilio credentials safely.

3. In the send_message.py file, replace the value for to with the recipient phone number in E.164 format.

   To send a message to multiple recipients:

   1. Add a statement below client to define the array of phone numbers. Replace the phone numbers with your recipients' phone numbers in E.164 format.

      Copy code block

      numbers = ["+15558675310", "+12345678901", "+10987654321"]

   2. Replace the message = and print() statements with the following code that iterates through each phone number in the numbers list and returns the message sent to each number. Twilio makes one API call for each number.

      Copy code block

      1
      for number in numbers:
      2
          message = client.messages.create(
      3
              body="This is the ship that made the Kessel Run in fourteen parsecs?",
      4
              from_="+15017122661",
      5
              to=number,
      6
          )
      7
          print(f"Sent to {number}: {message.body}")

   (information)

   Limits on message cadence

   Message delivery performance to wireless carrier networks has limits. To learn more, see Understanding Twilio Rate Limits and Message Queues.

4. Replace the value for from with your Twilio phone number in E.164 format.

5. Save your changes and run this command from your terminal in the directory that contains send_message.py:

   Copy code block

   python send_message.py

   After a few moments, you receive an SMS from your Twilio number.

1. Create and open a new file called send_message.js anywhere on your machine and paste in the following code:

   Send an SMS Using Twilio with Node.js

   Report code block

   Copy code block

   1
   // Download the helper library from https://www.twilio.com/docs/node/install
   2
   const twilio = require("twilio"); // Or, for ESM: import twilio from "twilio";
   3
   
   4
   // Find your Account SID and Auth Token at twilio.com/console
   5
   // and set the environment variables. See http://twil.io/secure
   6
   const accountSid = process.env.TWILIO_ACCOUNT_SID;
   7
   const authToken = process.env.TWILIO_AUTH_TOKEN;
   8
   const client = twilio(accountSid, authToken);
   9
   
   10
   async function createMessage() {
   11
     const message = await client.messages.create({
   12
       body: "This is the ship that made the Kessel Run in fourteen parsecs?",
   13
       from: "+15017122661",
   14
       to: "+15558675310",
   15
     });
   16
   
   17
     console.log(message.body);
   18
   }
   19
   
   20
   createMessage();

   To learn all of the API response values that you can return with console.log(), see the response for Send an SMS Message in the API documentation. Precede the response value with message. (for example: console.log(message.status) returns the status value).

2. Set the environment variables for your Account SID and Auth Token.

   (warning)

   Improve security with API keys

   To better control access, use API keys instead of the Account SID and Auth Token when you deploy to production. To learn more, see Why you should use API keys.

   On Mac or Linux:

   1. Run the following commands to add your credentials as environment variables in a twilio.env file and source them. Replace ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX with your Account SID and replace your_auth_token with your Auth Token.

      Copy code block

      1
      echo "export TWILIO_ACCOUNT_SID='ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX'" > twilio.env
      2
      echo "export TWILIO_AUTH_TOKEN='your_auth_token'" >> twilio.env
      3
      source ./twilio.env

   2. If you're committing code with git, run the following command to add the twilio.env file to .gitignore to avoid uploading your credentials in plain text:

      Copy code block

      echo "twilio.env" >> .gitignore

   On Windows command line (cmd.exe), run the following commands. Replace ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX with your Account SID and replace your_auth_token with your Auth Token.

   Copy code block

   1
   set TWILIO_ACCOUNT_SID=ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
   2
   set TWILIO_AUTH_TOKEN=your_auth_token

   To learn more, see Store your Twilio credentials safely.

3. In the send_message.js file, replace the value for to with the recipient phone number in E.164 format.

   To send a message to multiple recipients:

   1. Add a const statement after the existing const statements to define the array of phone numbers. Replace the phone numbers with your recipients' phone numbers in E.164 format.

      Copy code block

      const numbers = ["+15558675310", "+12345678901", "+10987654321"];

   2. Replace the async function createMessage() block with the following code that iterates through each phone number in the numbers list and returns the message sent to each number. Twilio makes one API call for each number.

      Copy code block

      1
      async function createMessage() {
      2
        for (const number of numbers) {
      3
          const message = await client.messages.create({
      4
            body: "This is the ship that made the Kessel Run in fourteen parsecs?",
      5
            from: "+15017122661",
      6
            to: number,
      7
          });
      8
      
      9
          console.log(`Sent to ${number}: ${message.body}`);
      10
        }
      11
      }

   (information)

   Limits on message cadence

   Message delivery performance to wireless carrier networks has limits. To learn more, see Understanding Twilio Rate Limits and Message Queues.

4. Replace the value for from with your Twilio phone number in E.164 format.

5. Save your changes and run this command from your terminal in the directory that contains send_message.js:

   Copy code block

   node send_message.js

   After a few moments, you receive an SMS from your Twilio number.

1. Create and open a new file called send_message.php in the project directory and paste in the following code:

   Send an SMS Using Twilio with PHP

   Report code block

   Copy code block

   1
   <?php
   2
   
   3
   // Update the path below to your autoload.php,
   4
   // see https://getcomposer.org/doc/01-basic-usage.md
   5
   require_once "/path/to/vendor/autoload.php";
   6
   
   7
   use Twilio\Rest\Client;
   8
   
   9
   // Find your Account SID and Auth Token at twilio.com/console
   10
   // and set the environment variables. See http://twil.io/secure
   11
   $sid = getenv("TWILIO_ACCOUNT_SID");
   12
   $token = getenv("TWILIO_AUTH_TOKEN");
   13
   $twilio = new Client($sid, $token);
   14
   
   15
   $message = $twilio->messages->create(
   16
       "+15558675310", // To
   17
       [
   18
           "body" =>
   19
               "This is the ship that made the Kessel Run in fourteen parsecs?",
   20
           "from" => "+15017122661",
   21
       ]
   22
   );
   23
   
   24
   print $message->body;

   To learn all of the API response values that you can return with print, see the response for Send an SMS Message in the API documentation. Precede the response value with $message-> (for example: print $message->status; returns the status value).

2. Set the environment variables for your Account SID and Auth Token.

   (warning)

   Improve security with API keys

   To better control access, use API keys instead of the Account SID and Auth Token when you deploy to production. To learn more, see Why you should use API keys.

   On Mac or Linux:

   1. Run the following commands to add your credentials as environment variables in a twilio.env file and source them. Replace ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX with your Account SID and replace your_auth_token with your Auth Token.

      Copy code block

      1
      echo "export TWILIO_ACCOUNT_SID='ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX'" > twilio.env
      2
      echo "export TWILIO_AUTH_TOKEN='your_auth_token'" >> twilio.env
      3
      source ./twilio.env

   2. If you're committing code with git, run the following command to add the twilio.env file to .gitignore to avoid uploading your credentials in plain text:

      Copy code block

      echo "twilio.env" >> .gitignore

   On Windows command line (cmd.exe), run the following commands. Replace ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX with your Account SID and replace your_auth_token with your Auth Token.

   Copy code block

   1
   set TWILIO_ACCOUNT_SID=ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
   2
   set TWILIO_AUTH_TOKEN=your_auth_token

   To learn more, see Store your Twilio credentials safely.

3. In the send_message.php file, replace the value for to with the recipient phone number in E.164 format.

   To send a message to multiple recipients:

   1. Add a statement after the $twilio to define the array of phone numbers. Replace the phone numbers with your recipients' phone numbers in E.164 format.

      Copy code block

      $numbers = ["+15558675310", "+12345678901", "+10987654321"];

   2. Replace the $message = and print statements with the following code that iterates through each phone number in the numbers list and returns the message sent to each number. Twilio makes one API call for each number.

      Copy code block

      1
      foreach ($numbers as $to) {
      2
          $message = $twilio->messages->create(
      3
              $to, // To
      4
              [
      5
                  "body" =>
      6
                      "This is the ship that made the Kessel Run in fourteen parsecs?",
      7
                  "from" => "+15017122661",
      8
              ]
      9
          );
      10
      
      11
          print "Sent to $to: " . $message->body . "\n";
      12
      }

   (information)

   Limits on message cadence

   Message delivery performance to wireless carrier networks has limits. To learn more, see Understanding Twilio Rate Limits and Message Queues.

4. Replace the value for from with your Twilio phone number in E.164 format.

5. Update line 5 of send_message.php to require __DIR__ . '/vendor/autoload.php';

6. Save your changes and run this command from your terminal in the directory that contains send_message.php:

   Copy code block

   php send_message.php

   After a few moments, you receive an SMS from your Twilio number.

1. Set the environment variables for your Account SID and Auth Token and start Visual Studio with the inherited variables.

   (warning)

   Improve security with API keys

   To better control access, use API keys instead of the Account SID and Auth Token when you deploy to production. To learn more, see Why you should use API keys.

   On Windows command line (cmd.exe), run the following commands. Replace ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX with your Account SID and replace your_auth_token with your Auth Token.

   Copy code block

   1
   set TWILIO_ACCOUNT_SID=ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
   2
   set TWILIO_AUTH_TOKEN=your_auth_token
   3
   start devenv

   To learn more, see Store your Twilio credentials safely.

2. Create and set up a new project in Visual Studio:

   • In Visual Studio, click Create a new project.
   • Click Console App (.NET Framework).
   • Use the NuGet Package Manager to install the Twilio REST API helper library.

3. Open the file in your new Visual Studio project called Program.cs and paste in the following code, replacing the existing template code:

   Send an SMS Using Twilio with C# (.NET Framework)

   Report code block

   Copy code block

   1
   // Install the C# / .NET helper library from twilio.com/docs/csharp/install
   2
   
   3
   using System;
   4
   using Twilio;
   5
   using Twilio.Rest.Api.V2010.Account;
   6
   using System.Threading.Tasks;
   7
   
   8
   class Program {
   9
       public static async Task Main(string[] args) {
   10
           // Find your Account SID and Auth Token at twilio.com/console
   11
           // and set the environment variables. See http://twil.io/secure
   12
           string accountSid = Environment.GetEnvironmentVariable("TWILIO_ACCOUNT_SID");
   13
           string authToken = Environment.GetEnvironmentVariable("TWILIO_AUTH_TOKEN");
   14
   
   15
           TwilioClient.Init(accountSid, authToken);
   16
   
   17
           var message = await MessageResource.CreateAsync(
   18
               body: "Join Earth's mightiest heroes. Like Kevin Bacon.",
   19
               from: new Twilio.Types.PhoneNumber("+15017122661"),
   20
               to: new Twilio.Types.PhoneNumber("+15558675310"));
   21
   
   22
           Console.WriteLine(message.Body);
   23
       }
   24
   }

   To learn all of the API response values that you can return with Console.WriteLine(), see the response for Send an SMS Message in the API documentation. Precede the response value with message. and capitalize the first letter of the response value (for example: Console.WriteLine(message.Status) returns the status value).

4. In the Program.cs file, replace the value for to: new Twilio.Types.PhoneNumber with the recipient phone number in E.164 format.

   To send a message to multiple recipients, replace the class Program statement with the following code that iterates through each phone number in the numbers list and returns the message sent to each number. Replace the phone numbers with your recipients' phone numbers in E.164 format. Twilio makes one API call for each number.

   Copy code block

   1
   class Program {
   2
       public static async Task Main(string[] args) {
   3
           // Find your Account SID and Auth Token at twilio.com/console
   4
           // and set the environment variables. See https://twil.io/secure
   5
           string accountSid = Environment.GetEnvironmentVariable("TWILIO_ACCOUNT_SID");
   6
           string authToken = Environment.GetEnvironmentVariable("TWILIO_AUTH_TOKEN");
   7
   
   8
           TwilioClient.Init(accountSid, authToken);
   9
   
   10
           string[] numbers = { "+15558675310", "+12345678901", "+10987654321" };
   11
   
   12
           foreach (var number in numbers) {
   13
               var message = await MessageResource.CreateAsync(
   14
                   body: "Join Earth's mightiest heroes. Like Kevin Bacon.",
   15
                   from: new Twilio.Types.PhoneNumber("+15017122661"),
   16
                   to: new Twilio.Types.PhoneNumber(number));
   17
   
   18
                Console.WriteLine(message.Body);
   19
           }
   20
       }
   21
   }

   (information)

   Limits on message cadence

   Message delivery performance to wireless carrier networks has limits. To learn more, see Understanding Twilio Rate Limits and Message Queues.

5. Replace the value for from: new Twilio.Types.PhoneNumber with your Twilio phone number in E.164 format.

6. Save your changes and run your project in Visual Studio.

   After a few moments, you receive an SMS from your Twilio number.

1. Run the following commands to create a new .NET project and install the Twilio NuGet package:

   Copy code block

   1
   mkdir TwilioSend
   2
   cd TwilioSend
   3
   dotnet new console
   4
   dotnet add package Twilio

2. Open the file in your new project called Program.cs and paste in the following code, replacing the existing template code:

   Send an SMS Using Twilio with C# (.NET Core)

   Report code block

   Copy code block

   1
   // Install the C# / .NET helper library from twilio.com/docs/csharp/install
   2
   
   3
   using System;
   4
   using Twilio;
   5
   using Twilio.Rest.Api.V2010.Account;
   6
   using System.Threading.Tasks;
   7
   
   8
   class Program {
   9
       public static async Task Main(string[] args) {
   10
           // Find your Account SID and Auth Token at twilio.com/console
   11
           // and set the environment variables. See http://twil.io/secure
   12
           string accountSid = Environment.GetEnvironmentVariable("TWILIO_ACCOUNT_SID");
   13
           string authToken = Environment.GetEnvironmentVariable("TWILIO_AUTH_TOKEN");
   14
   
   15
           TwilioClient.Init(accountSid, authToken);
   16
   
   17
           var message = await MessageResource.CreateAsync(
   18
               body: "Join Earth's mightiest heroes. Like Kevin Bacon.",
   19
               from: new Twilio.Types.PhoneNumber("+15017122661"),
   20
               to: new Twilio.Types.PhoneNumber("+15558675310"));
   21
   
   22
           Console.WriteLine(message.Body);
   23
       }
   24
   }

   To learn all of the API response values that you can return with Console.WriteLine(), see the response for Send an SMS Message in the API documentation. Precede the response value with message. and capitalize the first letter of the response value (for example: Console.WriteLine(message.Status) returns the status value).

3. Set the environment variables for your Account SID and Auth Token.

   (warning)

   Improve security with API keys

   To better control access, use API keys instead of the Account SID and Auth Token when you deploy to production. To learn more, see Why you should use API keys.

   On Mac or Linux:

   1. Run the following commands to add your credentials as environment variables in a twilio.env file and source them. Replace ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX with your Account SID and replace your_auth_token with your Auth Token.

      Copy code block

      1
      echo "export TWILIO_ACCOUNT_SID='ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX'" > twilio.env
      2
      echo "export TWILIO_AUTH_TOKEN='your_auth_token'" >> twilio.env
      3
      source ./twilio.env

   2. If you're committing code with git, run the following command to add the twilio.env file to .gitignore to avoid uploading your credentials in plain text:

      Copy code block

      echo "twilio.env" >> .gitignore

   On Windows command line (cmd.exe), run the following commands. Replace ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX with your Account SID and replace your_auth_token with your Auth Token.

   Copy code block

   1
   set TWILIO_ACCOUNT_SID=ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
   2
   set TWILIO_AUTH_TOKEN=your_auth_token

   To learn more, see Store your Twilio credentials safely.

4. In the Program.cs file, replace the value for to: new Twilio.Types.PhoneNumber with the recipient phone number in E.164 format.

   To send a message to multiple recipients, replace the class Program statement with the following code that iterates through each phone number in the numbers list and returns the message sent to each number. Replace the phone numbers with your recipients' phone numbers in E.164 format. Twilio makes one API call for each number.

   Copy code block

   1
   class Program {
   2
       public static async Task Main(string[] args) {
   3
           // Find your Account SID and Auth Token at twilio.com/console
   4
           // and set the environment variables. See https://twil.io/secure
   5
           string accountSid = Environment.GetEnvironmentVariable("TWILIO_ACCOUNT_SID");
   6
           string authToken = Environment.GetEnvironmentVariable("TWILIO_AUTH_TOKEN");
   7
   
   8
           TwilioClient.Init(accountSid, authToken);
   9
   
   10
           string[] numbers = { "+15558675310", "+12345678901", "+10987654321" };
   11
   
   12
           foreach (var number in numbers) {
   13
               var message = await MessageResource.CreateAsync(
   14
                   body: "Join Earth's mightiest heroes. Like Kevin Bacon.",
   15
                   from: new Twilio.Types.PhoneNumber("+15017122661"),
   16
                   to: new Twilio.Types.PhoneNumber(number));
   17
   
   18
                Console.WriteLine(message.Body);
   19
           }
   20
       }
   21
   }

   (information)

   Limits on message cadence

   Message delivery performance to wireless carrier networks has limits. To learn more, see Understanding Twilio Rate Limits and Message Queues.

5. Replace the value for from: new Twilio.Types.PhoneNumber with your Twilio phone number in E.164 format.

6. Save your changes and run this command in the directory that contains Program.cs:

   Copy code block

   dotnet run

   After a few moments, you receive an SMS from your Twilio number.

1. Create and open a new file called Example.java in the same directory as the fat jar file and paste in the following code:

   Send an SMS Using Twilio with Java

   Report code block

   Copy code block

   1
   // Install the Java helper library from twilio.com/docs/java/install
   2
   
   3
   import com.twilio.type.PhoneNumber;
   4
   import com.twilio.Twilio;
   5
   import com.twilio.rest.api.v2010.account.Message;
   6
   
   7
   public class Example {
   8
       // Find your Account SID and Auth Token at twilio.com/console
   9
       // and set the environment variables. See http://twil.io/secure
   10
       public static final String ACCOUNT_SID = System.getenv("TWILIO_ACCOUNT_SID");
   11
       public static final String AUTH_TOKEN = System.getenv("TWILIO_AUTH_TOKEN");
   12
   
   13
       public static void main(String[] args) {
   14
           Twilio.init(ACCOUNT_SID, AUTH_TOKEN);
   15
           Message message = Message
   16
                                 .creator(new com.twilio.type.PhoneNumber("+15558675310"),
   17
                                     new com.twilio.type.PhoneNumber("+15017122661"),
   18
                                     "This is the ship that made the Kessel Run in fourteen parsecs?")
   19
                                 .create();
   20
   
   21
           System.out.println(message.getBody());
   22
       }
   23
   }

   To learn all of the API response values that you can return with System.out.println();, see the response for Send an SMS Message in the API documentation. Precede the response value with message.get, capitalize the response value, and add parentheses after the response value (for example: System.out.println(message.getStatus()); returns the status value).

2. Set the environment variables for your Account SID and Auth Token.

   (warning)

   Improve security with API keys

   To better control access, use API keys instead of the Account SID and Auth Token when you deploy to production. To learn more, see Why you should use API keys.

   On Mac or Linux:

   1. Run the following commands to add your credentials as environment variables in a twilio.env file and source them. Replace ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX with your Account SID and replace your_auth_token with your Auth Token.

      Copy code block

      1
      echo "export TWILIO_ACCOUNT_SID='ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX'" > twilio.env
      2
      echo "export TWILIO_AUTH_TOKEN='your_auth_token'" >> twilio.env
      3
      source ./twilio.env

   2. If you're committing code with git, run the following command to add the twilio.env file to .gitignore to avoid uploading your credentials in plain text:

      Copy code block

      echo "twilio.env" >> .gitignore

   On Windows command line (cmd.exe), run the following commands. Replace ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX with your Account SID and replace your_auth_token with your Auth Token.

   Copy code block

   1
   set TWILIO_ACCOUNT_SID=ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
   2
   set TWILIO_AUTH_TOKEN=your_auth_token

   To learn more, see Store your Twilio credentials safely.

3. In the Example.java file, replace the value for the first phone number with the recipient phone number in E.164 format.

   To send a message to multiple recipients:

   1. Replace the contents of the public static void main(String[] args) block with the following code that iterates through each phone number in a numbers list and returns the message sent to each number. Twilio makes one API call for each number.

      Copy code block

      1
      Twilio.init(ACCOUNT_SID, AUTH_TOKEN);
      2
      
      3
       String[] numbers = {"+15558675310", "+12345678901", "+10987654321"};
      4
      
      5
      for (String to : numbers) {
      6
          Message message = Message
      7
                                 .creator(new PhoneNumber(to),
      8
                                     new PhoneNumber("+15017122661"),
      9
                                     "This is the ship that made the Kessel Run in fourteen parsecs?")
      10
                                .create();
      11
      
      12
          System.out.println(message.getBody());
      13
      }

   2. Replace the phone numbers in the numbers list with your recipients' phone numbers in E.164 format.

   (information)

   Limits on message cadence

   Message delivery performance to wireless carrier networks has limits. To learn more, see Understanding Twilio Rate Limits and Message Queues.

4. Replace the value for the second new PhoneNumber() with your Twilio phone number in E.164 format.

5. Save your changes and compile the Java from your terminal in the directory that contains Example.java. Replace 10.9.0 with the version of your fat jar file.

   Copy code block

   javac -cp twilio-10.9.0-jar-with-dependencies.jar Example.java

6. Run the Java. Replace 10.9.0 with the version of your fat jar file. On Linux or macOS, run:

   Copy code block

   java -cp .:twilio-10.9.0-jar-with-dependencies.jar Example

   On Windows, run:

   Copy code block

   java -cp ".;twilio-10.9.0-jar-with-dependencies.jar" Example

   After a few moments, you receive an SMS from your Twilio number.

1. Create and set up your Go project.

   1. Create a new Go project by running the following command:

      Copy code block

      go mod init twilio-example

   2. Install the Twilio Go helper library:

      Copy code block

      go get github.com/twilio/twilio-go

2. Create and open a new file called send_message.go in your Go project directory and paste in the following code:

   Send an SMS Using Twilio with Go

   Report code block

   Copy code block

   1
   // Download the helper library from https://www.twilio.com/docs/go/install
   2
   package main
   3
   
   4
   import (
   5
   	"fmt"
   6
   	"github.com/twilio/twilio-go"
   7
   	api "github.com/twilio/twilio-go/rest/api/v2010"
   8
   	"os"
   9
   )
   10
   
   11
   func main() {
   12
   	// Find your Account SID and Auth Token at twilio.com/console
   13
   	// and set the environment variables. See http://twil.io/secure
   14
   	// Make sure TWILIO_ACCOUNT_SID and TWILIO_AUTH_TOKEN exists in your environment
   15
   	client := twilio.NewRestClient()
   16
   
   17
   	params := &api.CreateMessageParams{}
   18
   	params.SetBody("Join Earth's mightiest heroes. Like Kevin Bacon.")
   19
   	params.SetFrom("+15017122661")
   20
   	params.SetTo("+15558675310")
   21
   
   22
   	resp, err := client.Api.CreateMessage(params)
   23
   	if err != nil {
   24
   		fmt.Println(err.Error())
   25
   		os.Exit(1)
   26
   	} else {
   27
   		if resp.Body != nil {
   28
   			fmt.Println(*resp.Body)
   29
   		} else {
   30
   			fmt.Println(resp.Body)
   31
   		}
   32
   	}
   33
   }

   To learn all of the API response values that you can return with fmt.Println(), see the response for Send an SMS Message in the API documentation. Precede the response value with *resp. and capitalize the first letter of the response value (for example: fmt.Println(*resp.Status) returns the status value).

3. Set the environment variables for your Account SID and Auth Token.

   (warning)

   Improve security with API keys

   To better control access, use API keys instead of the Account SID and Auth Token when you deploy to production. To learn more, see Why you should use API keys.

   On Mac or Linux:

   1. Run the following commands to add your credentials as environment variables in a twilio.env file and source them. Replace ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX with your Account SID and replace your_auth_token with your Auth Token.

      Copy code block

      1
      echo "export TWILIO_ACCOUNT_SID='ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX'" > twilio.env
      2
      echo "export TWILIO_AUTH_TOKEN='your_auth_token'" >> twilio.env
      3
      source ./twilio.env

   2. If you're committing code with git, run the following command to add the twilio.env file to .gitignore to avoid uploading your credentials in plain text:

      Copy code block

      echo "twilio.env" >> .gitignore

   On Windows command line (cmd.exe), run the following commands. Replace ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX with your Account SID and replace your_auth_token with your Auth Token.

   Copy code block

   1
   set TWILIO_ACCOUNT_SID=ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
   2
   set TWILIO_AUTH_TOKEN=your_auth_token

   To learn more, see Store your Twilio credentials safely.

4. In the send_message.go file, replace the value for to with the recipient phone number in E.164 format.

   To send a message to multiple recipients:

   1. Add a statement below client to define the array of phone numbers. Replace the phone numbers with your recipients' phone numbers in E.164 format.

      Copy code block

      numbers := []string{"+15558675310", "+12345678901", "+10987654321"}

   2. Replace the params statements with the following code that iterates through each phone number in the numbers list. Twilio makes one API call for each number.

      Copy code block

      1
        for _, number := range numbers {
      2
            params := &api.CreateMessageParams{}
      3
            params.SetBody("Join Earth's mightiest heroes. Like Kevin Bacon.")
      4
            params.SetFrom("+15017122661")
      5
            params.SetTo(number)

   3. Add an additional closing bracket } to the end of the file.

   (information)

   Limits on message cadence

   Message delivery performance to wireless carrier networks has limits. To learn more, see Understanding Twilio Rate Limits and Message Queues.

5. Replace the value for params.SetFrom with your Twilio phone number in E.164 format.

6. Save your changes and run this command in the directory that contains send_message.go:

   Copy code block

   go run send_message.go

   After a few moments, you receive an SMS from your Twilio number.

1. Create and open a new file called send_message.rb anywhere on your machine and paste in the following code:

   Send an SMS Using Twilio with Ruby

   Report code block

   Copy code block

   1
   # Download the helper library from https://www.twilio.com/docs/ruby/install
   2
   require 'rubygems'
   3
   require 'twilio-ruby'
   4
   
   5
   # Find your Account SID and Auth Token at twilio.com/console
   6
   # and set the environment variables. See http://twil.io/secure
   7
   account_sid = ENV['TWILIO_ACCOUNT_SID']
   8
   auth_token = ENV['TWILIO_AUTH_TOKEN']
   9
   @client = Twilio::REST::Client.new(account_sid, auth_token)
   10
   
   11
   message = @client
   12
             .api
   13
             .v2010
   14
             .messages
   15
             .create(
   16
               body: 'Join Earth\'s mightiest heroes. Like Kevin Bacon.',
   17
               from: '+15017122661',
   18
               to: '+15558675310'
   19
             )
   20
   
   21
   puts message.body

   To learn all of the API response values that you can return with puts, see the response for Send an SMS Message in the API documentation. Precede the response value with message. (for example: puts message.status returns the status value).

2. Set the environment variables for your Account SID and Auth Token.

   (warning)

   Improve security with API keys

   To better control access, use API keys instead of the Account SID and Auth Token when you deploy to production. To learn more, see Why you should use API keys.

   On Mac or Linux:

   1. Run the following commands to add your credentials as environment variables in a twilio.env file and source them. Replace ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX with your Account SID and replace your_auth_token with your Auth Token.

      Copy code block

      1
      echo "export TWILIO_ACCOUNT_SID='ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX'" > twilio.env
      2
      echo "export TWILIO_AUTH_TOKEN='your_auth_token'" >> twilio.env
      3
      source ./twilio.env

   2. If you're committing code with git, run the following command to add the twilio.env file to .gitignore to avoid uploading your credentials in plain text:

      Copy code block

      echo "twilio.env" >> .gitignore

   On Windows command line (cmd.exe), run the following commands. Replace ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX with your Account SID and replace your_auth_token with your Auth Token.

   Copy code block

   1
   set TWILIO_ACCOUNT_SID=ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
   2
   set TWILIO_AUTH_TOKEN=your_auth_token

   To learn more, see Store your Twilio credentials safely.

3. In the send_message.rb file, replace the value for to with the recipient phone number in E.164 format.

   To send a message to multiple recipients:

   1. Add a statement below @client to define the array of phone numbers. Replace the phone numbers with your recipients' phone numbers in E.164 format.

      Copy code block

      numbers = ['+15558675310', '+12345678901', '+10987654321']

   2. Replace the message = and puts statements with the following code that iterates through each phone number in the numbers list. Twilio makes one API call for each number.

      Copy code block

      1
      numbers.each do |number|
      2
        message = @client
      3
                  .api
      4
                  .v2010
      5
                  .messages
      6
                  .create(
      7
                    body: 'Join Earth\'s mightiest heroes. Like Kevin Bacon.',
      8
                    from: '+15017122661',
      9
                    to: number
      10
                  )
      11
        puts message.body
      12
      end

   (information)

   Limits on message cadence

   Message delivery performance to wireless carrier networks has limits. To learn more, see Understanding Twilio Rate Limits and Message Queues.

4. Replace the value for from with your Twilio phone number in E.164 format.

5. Save your changes and run this command from your terminal in the directory that contains send_message.rb:

   Copy code block

   ruby send_message.rb

   After a few moments, you receive an SMS from your Twilio number.

1. Set the environment variables for your Account SID, Auth Token, your Twilio phone number in E.164 format, and the recipient's phone number in E.164 format.

   (warning)

   Improve security with API keys

   To better control access, use API keys instead of the Account SID and Auth Token when you deploy to production. To learn more, see Why you should use API keys.

   On macOS or Linux, run the following commands. Replace xxxxxxxxx with your values.

   Copy code block

   1
   export TWILIO_ACCOUNT_SID=xxxxxxxxx
   2
   export TWILIO_AUTH_TOKEN=xxxxxxxxx
   3
   export TWILIO_NUMBER=xxxxxxxxx
   4
   export TO_NUMBER=xxxxxxxxx

   On Windows command line (cmd.exe), run the following commands. Replace xxxxxxxxx with your values.

   Copy code block

   1
   set TWILIO_ACCOUNT_SID=xxxxxxxxx
   2
   set TWILIO_AUTH_TOKEN=xxxxxxxxx
   3
   set TWILIO_NUMBER=xxxxxxxxx
   4
   set TO_NUMBER=xxxxxxxxx

   To learn more, see Store your Twilio credentials safely.

2. Run the cURL command from your terminal.

   On macOS or Linux, run the following command. Replace the Body value with the message you want to send.

   Copy code block

   curl -X POST -d "Body=Hi there, this is a test message from cURL" -d "From=$TWILIO_NUMBER" -d "To=$TO_NUMBER" "https://api.twilio.com/2010-04-01/Accounts/$TWILIO_ACCOUNT_SID/Messages" -u "$TWILIO_ACCOUNT_SID:$TWILIO_AUTH_TOKEN"

   On Windows, run the following command. Replace the Body value with the message you want to send.

   Copy code block

   curl -X POST -d "Body=Hi there, this is a test message from cURL" -d "From=%TWILIO_NUMBER%" -d "To=%TO_NUMBER%" "https://api.twilio.com/2010-04-01/Accounts/%TWILIO_ACCOUNT_SID%/Messages" -u "%TWILIO_ACCOUNT_SID%:%TWILIO_AUTH_TOKEN%"

   After a few moments, you receive an SMS from your Twilio number.

To send an MMS message, follow the steps to send an SMS message, adding the media URL to the code as shown in the following example. The media URL tells Twilio where to get the media you want to include.

The media URL must be a publicly accessible URL. Twilio can't reach any hidden URLs or URLs that require authentication.

When the Twilio REST API creates your new Message resource, it saves the image found at the specified in the media URL as a Media resource. Once you create a resource, you can access it at any time by using the API.

Set the media_url parameter:

1
# Download the helper library from https://www.twilio.com/docs/python/install
2
import os
3
from twilio.rest import Client
4

5
# Find your Account SID and Auth Token at twilio.com/console
6
# and set the environment variables. See http://twil.io/secure
7
account_sid = os.environ["TWILIO_ACCOUNT_SID"]
8
auth_token = os.environ["TWILIO_AUTH_TOKEN"]
9
client = Client(account_sid, auth_token)
10

11
message = client.messages.create(
12
    body="This is the ship that made the Kessel Run in fourteen parsecs?",
13
    from_="+15017122661",
14
    media_url=[
15
        "https://c1.staticflickr.com/3/2899/14341091933_1e92e62d12_b.jpg"
16
    ],
17
    to="+15558675310",
18
)
19

20
print(message.body)

To send an MMS message, follow the steps to send an SMS message, adding the media URL to the code as shown in the following example. The media URL tells Twilio where to get the media you want to include.

The media URL must be a publicly accessible URL. Twilio can't reach any hidden URLs or URLs that require authentication.

When the Twilio REST API creates your new Message resource, it saves the image found at the specified in the media URL as a Media resource. Once you create a resource, you can access it at any time by using the API.

Set the mediaUrl parameter:

1
// Download the helper library from https://www.twilio.com/docs/node/install
2
const twilio = require("twilio"); // Or, for ESM: import twilio from "twilio";
3

4
// Find your Account SID and Auth Token at twilio.com/console
5
// and set the environment variables. See http://twil.io/secure
6
const accountSid = process.env.TWILIO_ACCOUNT_SID;
7
const authToken = process.env.TWILIO_AUTH_TOKEN;
8
const client = twilio(accountSid, authToken);
9

10
async function createMessage() {
11
  const message = await client.messages.create({
12
    body: "This is the ship that made the Kessel Run in fourteen parsecs?",
13
    from: "+15017122661",
14
    mediaUrl: [
15
      "https://c1.staticflickr.com/3/2899/14341091933_1e92e62d12_b.jpg",
16
    ],
17
    to: "+15558675310",
18
  });
19

20
  console.log(message.body);
21
}
22

23
createMessage();

To send an MMS message, follow the steps to send an SMS message, adding the media URL to the code as shown in the following example. The media URL tells Twilio where to get the media you want to include.

The media URL must be a publicly accessible URL. Twilio can't reach any hidden URLs or URLs that require authentication.

When the Twilio REST API creates your new Message resource, it saves the image found at the specified in the media URL as a Media resource. Once you create a resource, you can access it at any time by using the API.

Set the mediaUrl parameter:

1
<?php
2

3
// Update the path below to your autoload.php,
4
// see https://getcomposer.org/doc/01-basic-usage.md
5
require_once "/path/to/vendor/autoload.php";
6

7
use Twilio\Rest\Client;
8

9
// Find your Account SID and Auth Token at twilio.com/console
10
// and set the environment variables. See http://twil.io/secure
11
$sid = getenv("TWILIO_ACCOUNT_SID");
12
$token = getenv("TWILIO_AUTH_TOKEN");
13
$twilio = new Client($sid, $token);
14

15
$message = $twilio->messages->create(
16
    "+15558675310", // To
17
    [
18
        "body" =>
19
            "This is the ship that made the Kessel Run in fourteen parsecs?",
20
        "from" => "+15017122661",
21
        "mediaUrl" => [
22
            "https://c1.staticflickr.com/3/2899/14341091933_1e92e62d12_b.jpg",
23
        ],
24
    ]
25
);
26

27
print $message->body;

To send an MMS message, follow the steps to send an SMS message, adding the media URL to the code as shown in the following example. The media URL tells Twilio where to get the media you want to include.

The media URL must be a publicly accessible URL. Twilio can't reach any hidden URLs or URLs that require authentication.

When the Twilio REST API creates your new Message resource, it saves the image found at the specified in the media URL as a Media resource. Once you create a resource, you can access it at any time by using the API.

Set the mediaUrl parameter:

1
// Install the C# / .NET helper library from twilio.com/docs/csharp/install
2

3
using System;
4
using Twilio;
5
using Twilio.Rest.Api.V2010.Account;
6
using System.Threading.Tasks;
7
using System.Collections.Generic;
8

9
class Program {
10
    public static async Task Main(string[] args) {
11
        // Find your Account SID and Auth Token at twilio.com/console
12
        // and set the environment variables. See http://twil.io/secure
13
        string accountSid = Environment.GetEnvironmentVariable("TWILIO_ACCOUNT_SID");
14
        string authToken = Environment.GetEnvironmentVariable("TWILIO_AUTH_TOKEN");
15

16
        TwilioClient.Init(accountSid, authToken);
17

18
        var message = await MessageResource.CreateAsync(
19
            body: "This is the ship that made the Kessel Run in fourteen parsecs?",
20
            from: new Twilio.Types.PhoneNumber("+15017122661"),
21
            mediaUrl: new List<Uri> { new Uri(
22
                "https://c1.staticflickr.com/3/2899/14341091933_1e92e62d12_b.jpg") },
23
            to: new Twilio.Types.PhoneNumber("+15558675310"));
24

25
        Console.WriteLine(message.Body);
26
    }
27
}

To send an MMS message, follow the steps to send an SMS message, adding the media URL to the code as shown in the following example. The media URL tells Twilio where to get the media you want to include.

The media URL must be a publicly accessible URL. Twilio can't reach any hidden URLs or URLs that require authentication.

When the Twilio REST API creates your new Message resource, it saves the image found at the specified in the media URL as a Media resource. Once you create a resource, you can access it at any time by using the API.

Set the mediaUrl parameter:

1
// Install the C# / .NET helper library from twilio.com/docs/csharp/install
2

3
using System;
4
using Twilio;
5
using Twilio.Rest.Api.V2010.Account;
6
using System.Threading.Tasks;
7
using System.Collections.Generic;
8

9
class Program {
10
    public static async Task Main(string[] args) {
11
        // Find your Account SID and Auth Token at twilio.com/console
12
        // and set the environment variables. See http://twil.io/secure
13
        string accountSid = Environment.GetEnvironmentVariable("TWILIO_ACCOUNT_SID");
14
        string authToken = Environment.GetEnvironmentVariable("TWILIO_AUTH_TOKEN");
15

16
        TwilioClient.Init(accountSid, authToken);
17

18
        var message = await MessageResource.CreateAsync(
19
            body: "This is the ship that made the Kessel Run in fourteen parsecs?",
20
            from: new Twilio.Types.PhoneNumber("+15017122661"),
21
            mediaUrl: new List<Uri> { new Uri(
22
                "https://c1.staticflickr.com/3/2899/14341091933_1e92e62d12_b.jpg") },
23
            to: new Twilio.Types.PhoneNumber("+15558675310"));
24

25
        Console.WriteLine(message.Body);
26
    }
27
}

To send an MMS message, follow the steps to send an SMS message, adding the media URL to the code as shown in the following example. The media URL tells Twilio where to get the media you want to include.

The media URL must be a publicly accessible URL. Twilio can't reach any hidden URLs or URLs that require authentication.

When the Twilio REST API creates your new Message resource, it saves the image found at the specified in the media URL as a Media resource. Once you create a resource, you can access it at any time by using the API.

Add the required import statements for java.net.URI and java.util.Arrays and add the .setMediaUrl() statement:

1
// Install the Java helper library from twilio.com/docs/java/install
2

3
import com.twilio.type.PhoneNumber;
4
import java.net.URI;
5
import java.util.Arrays;
6
import com.twilio.Twilio;
7
import com.twilio.rest.api.v2010.account.Message;
8

9
public class Example {
10
    // Find your Account SID and Auth Token at twilio.com/console
11
    // and set the environment variables. See http://twil.io/secure
12
    public static final String ACCOUNT_SID = System.getenv("TWILIO_ACCOUNT_SID");
13
    public static final String AUTH_TOKEN = System.getenv("TWILIO_AUTH_TOKEN");
14

15
    public static void main(String[] args) {
16
        Twilio.init(ACCOUNT_SID, AUTH_TOKEN);
17
        Message message = Message
18
                              .creator(new com.twilio.type.PhoneNumber("+15558675310"),
19
                                  new com.twilio.type.PhoneNumber("+15017122661"),
20
                                  "This is the ship that made the Kessel Run in fourteen parsecs?")
21
                              .setMediaUrl(Arrays.asList(
22
                                  URI.create("https://c1.staticflickr.com/3/2899/14341091933_1e92e62d12_b.jpg")))
23
                              .create();
24

25
        System.out.println(message.getBody());
26
    }
27
}

To send an MMS message, follow the steps to send an SMS message, adding the media URL to the code as shown in the following example. The media URL tells Twilio where to get the media you want to include.

The media URL must be a publicly accessible URL. Twilio can't reach any hidden URLs or URLs that require authentication.

When the Twilio REST API creates your new Message resource, it saves the image found at the specified in the media URL as a Media resource. Once you create a resource, you can access it at any time by using the API.

Add the params.SetMediaUrl() statement:

1
// Download the helper library from https://www.twilio.com/docs/go/install
2
package main
3

4
import (
5
	"fmt"
6
	"github.com/twilio/twilio-go"
7
	api "github.com/twilio/twilio-go/rest/api/v2010"
8
	"os"
9
)
10

11
func main() {
12
	// Find your Account SID and Auth Token at twilio.com/console
13
	// and set the environment variables. See http://twil.io/secure
14
	// Make sure TWILIO_ACCOUNT_SID and TWILIO_AUTH_TOKEN exists in your environment
15
	client := twilio.NewRestClient()
16

17
	params := &api.CreateMessageParams{}
18
	params.SetBody("This is the ship that made the Kessel Run in fourteen parsecs?")
19
	params.SetFrom("+15017122661")
20
	params.SetMediaUrl([]string{
21
		"https://c1.staticflickr.com/3/2899/14341091933_1e92e62d12_b.jpg",
22
	})
23
	params.SetTo("+15558675310")
24

25
	resp, err := client.Api.CreateMessage(params)
26
	if err != nil {
27
		fmt.Println(err.Error())
28
		os.Exit(1)
29
	} else {
30
		if resp.Body != nil {
31
			fmt.Println(*resp.Body)
32
		} else {
33
			fmt.Println(resp.Body)
34
		}
35
	}
36
}

To send an MMS message, follow the steps to send an SMS message, adding the media URL to the code as shown in the following example. The media URL tells Twilio where to get the media you want to include.

The media URL must be a publicly accessible URL. Twilio can't reach any hidden URLs or URLs that require authentication.

When the Twilio REST API creates your new Message resource, it saves the image found at the specified in the media URL as a Media resource. Once you create a resource, you can access it at any time by using the API.

Set the media_url parameter:

1
# Download the helper library from https://www.twilio.com/docs/ruby/install
2
require 'rubygems'
3
require 'twilio-ruby'
4

5
# Find your Account SID and Auth Token at twilio.com/console
6
# and set the environment variables. See http://twil.io/secure
7
account_sid = ENV['TWILIO_ACCOUNT_SID']
8
auth_token = ENV['TWILIO_AUTH_TOKEN']
9
@client = Twilio::REST::Client.new(account_sid, auth_token)
10

11
message = @client
12
          .api
13
          .v2010
14
          .messages
15
          .create(
16
            body: 'This is the ship that made the Kessel Run in fourteen parsecs?',
17
            from: '+15017122661',
18
            media_url: [
19
              'https://c1.staticflickr.com/3/2899/14341091933_1e92e62d12_b.jpg'
20
            ],
21
            to: '+15558675310'
22
          )
23

24
puts message.body

To send an MMS message, follow the steps to send an SMS message, adding the media URL to the code as shown in the following example. The media URL tells Twilio where to get the media you want to include.

The media URL must be a publicly accessible URL. Twilio can't reach any hidden URLs or URLs that require authentication.

When the Twilio REST API creates your new Message resource, it saves the image found at the specified in the media URL as a Media resource. Once you create a resource, you can access it at any time by using the API.

Set the MediaUrl parameter:

On macOS or Linux:

curl -X POST -d "Body=Hi there, this is a test message from cURL" -d "MediaUrl=https://c1.staticflickr.com/3/2899/14341091933_1e92e62d12_b.jpg" -d "From=$TWILIO_NUMBER" -d "To=$TO_NUMBER" "https://api.twilio.com/2010-04-01/Accounts/$TWILIO_ACCOUNT_SID/Messages" -u "$TWILIO_ACCOUNT_SID:$TWILIO_AUTH_TOKEN"

On Windows:

curl -X POST -d "Body=Hi there, this is a test message from cURL" -d "MediaUrl=https://c1.staticflickr.com/3/2899/14341091933_1e92e62d12_b.jpg" -d "From=%TWILIO_NUMBER%" -d "To=%TO_NUMBER%" "https://api.twilio.com/2010-04-01/Accounts/%TWILIO_ACCOUNT_SID%/Messages" -u "%TWILIO_ACCOUNT_SID%:%TWILIO_AUTH_TOKEN%"