Send SMS and MMS messages

• Install Python.
• Install the Twilio Python SDK. 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. To acquire a phone number, go to Products & services > Numbers & senders and click Set up a new phone number.

  3. From the home page of the Console, copy your Account SID and paste it in a temporary local file for use later in this tutorial.

  4. Create an API key, then copy the SID and secret into the same file.

  5. 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 SDK:
  Copy code block

  npm install twilio

• Sign up for Twilio and get a phone number:

  1. Sign up for Twilio.

  2. To acquire a phone number, go to Products & services > Numbers & senders and click Set up a new phone number.

  3. From the home page of the Console, copy your Account SID and paste it in a temporary local file for use later in this tutorial.

  4. Create an API key, then copy the SID and secret into the same file.

  5. 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 SDK:
     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. To acquire a phone number, go to Products & services > Numbers & senders and click Set up a new phone number.

  3. From the home page of the Console, copy your Account SID and paste it in a temporary local file for use later in this tutorial.

  4. Create an API key, then copy the SID and secret into the same file.

  5. 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. To acquire a phone number, go to Products & services > Numbers & senders and click Set up a new phone number.

  3. From the home page of the Console, copy your Account SID and paste it in a temporary local file for use later in this tutorial.

  4. Create an API key, then copy the SID and secret into the same file.

  5. 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. To acquire a phone number, go to Products & services > Numbers & senders and click Set up a new phone number.

  3. From the home page of the Console, copy your Account SID and paste it in a temporary local file for use later in this tutorial.

  4. Create an API key, then copy the SID and secret into the same file.

  5. 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 fat JAR file for the Twilio Java SDK that includes 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. To acquire a phone number, go to Products & services > Numbers & senders and click Set up a new phone number.

  3. From the home page of the Console, copy your Account SID and paste it in a temporary local file for use later in this tutorial.

  4. Create an API key, then copy the SID and secret into the same file.

  5. 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. To acquire a phone number, go to Products & services > Numbers & senders and click Set up a new phone number.

  3. From the home page of the Console, copy your Account SID and paste it in a temporary local file for use later in this tutorial.

  4. Create an API key, then copy the SID and secret into the same file.

  5. 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 SDK:
  Copy code block

  gem install twilio-ruby

• Sign up for Twilio and get a phone number:

  1. Sign up for Twilio.

  2. To acquire a phone number, go to Products & services > Numbers & senders and click Set up a new phone number.

  3. From the home page of the Console, copy your Account SID and paste it in a temporary local file for use later in this tutorial.

  4. Create an API key, then copy the SID and secret into the same file.

  5. 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. To acquire a phone number, go to Products & services > Numbers & senders and click Set up a new phone number.

  3. From the home page of the Console, copy your Account SID and paste it in a temporary local file for use later in this tutorial.

  4. Create an API key, then copy the SID and secret into the same file.

  5. 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

   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 at twilio.com/console
   6
   # Provision API Keys at twilio.com/console/runtime/api-keys
   7
   # and set the environment variables. See http://twil.io/secure
   8
   # For local testing, you can use your Account SID and Auth token
   9
   api_key = os.environ["TWILIO_API_KEY"]
   10
   api_secret = os.environ["TWILIO_API_SECRET"]
   11
   account_sid = os.environ["TWILIO_ACCOUNT_SID"]
   12
   client = Client(api_key, api_secret, account_sid)
   13
   
   14
   message = client.messages.create(
   15
       body="Join Earth's mightiest heroes. Like Kevin Bacon.",
   16
       from_="+15017122661",
   17
       to="+15558675310",
   18
   )
   19
   
   20
   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, API key SID, and API key secret.

   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, SKXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX with your API key SID, and your_api_secret with your API key secret.

      Copy code block

      1
      echo "export TWILIO_ACCOUNT_SID='ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX'" > twilio.env
      2
      echo "export TWILIO_API_KEY='SKXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX'" >> twilio.env
      3
      echo "export TWILIO_API_SECRET='your_api_secret'" >> twilio.env
      4
      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, SKXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX with your API key SID, and your_api_secret with your API key secret.

   Copy code block

   1
   set TWILIO_ACCOUNT_SID=ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
   2
   set TWILIO_API_KEY=SKXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
   3
   set TWILIO_API_SECRET=your_api_secret

   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 should 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

   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 at twilio.com/console
   5
   // Provision API Keys at twilio.com/console/runtime/api-keys
   6
   // and set the environment variables. See http://twil.io/secure
   7
   // For local testing, you can use your Account SID and Auth token
   8
   const accountSid = process.env.TWILIO_ACCOUNT_SID;
   9
   const apiKey = process.env.TWILIO_API_KEY;
   10
   const apiSecret = process.env.TWILIO_API_SECRET;
   11
   const client = twilio(apiKey, apiSecret, { accountSid: accountSid });
   12
   
   13
   async function createMessage() {
   14
     const message = await client.messages.create({
   15
       body: "This is the ship that made the Kessel Run in fourteen parsecs?",
   16
       from: "+15017122661",
   17
       to: "+15558675310",
   18
     });
   19
   
   20
     console.log(message.body);
   21
   }
   22
   
   23
   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, API key SID, and API key secret.

   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, SKXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX with your API key SID, and your_api_secret with your API key secret.

      Copy code block

      1
      echo "export TWILIO_ACCOUNT_SID='ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX'" > twilio.env
      2
      echo "export TWILIO_API_KEY='SKXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX'" >> twilio.env
      3
      echo "export TWILIO_API_SECRET='your_api_secret'" >> twilio.env
      4
      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, SKXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX with your API key SID, and your_api_secret with your API key secret.

   Copy code block

   1
   set TWILIO_ACCOUNT_SID=ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
   2
   set TWILIO_API_KEY=SKXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
   3
   set TWILIO_API_SECRET=your_api_secret

   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

   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 at twilio.com/console
   10
   // Provision API Keys at twilio.com/console/runtime/api-keys
   11
   // and set the environment variables. See http://twil.io/secure
   12
   // For local testing, you can use your Account SID and Auth token
   13
   $apiKey = $_ENV["TWILIO_API_KEY"];
   14
   $apiSecret = $_ENV["TWILIO_API_SECRET"];
   15
   $sid = $_ENV["TWILIO_ACCOUNT_SID"];
   16
   $twilio = new Client($apiKey, $apiSecret, $sid);
   17
   
   18
   $message = $twilio->messages->create(
   19
       "+15558675310", // To
   20
       [
   21
           "body" =>
   22
               "This is the ship that made the Kessel Run in fourteen parsecs?",
   23
           "from" => "+15017122661",
   24
       ],
   25
   );
   26
   
   27
   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, API key SID, and API key secret.

   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, SKXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX with your API key SID, and your_api_secret with your API key secret.

      Copy code block

      1
      echo "export TWILIO_ACCOUNT_SID='ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX'" > twilio.env
      2
      echo "export TWILIO_API_KEY='SKXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX'" >> twilio.env
      3
      echo "export TWILIO_API_SECRET='your_api_secret'" >> twilio.env
      4
      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, SKXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX with your API key SID, and your_api_secret with your API key secret.

   Copy code block

   1
   set TWILIO_ACCOUNT_SID=ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
   2
   set TWILIO_API_KEY=SKXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
   3
   set TWILIO_API_SECRET=your_api_secret

   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, API key SID, and API key secret.

2. Start Visual Studio so it inherits those variables.

   On Windows command line (cmd.exe), run the following commands. Replace ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX with your Account SID, SKXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX with your API key SID, and your_api_secret with your API key secret.

   Copy code block

   1
   set TWILIO_ACCOUNT_SID=ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
   2
   set TWILIO_API_KEY=SKXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
   3
   set TWILIO_API_SECRET=your_api_secret
   4
   start devenv

   To learn more, see Store your Twilio credentials safely.

3. 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 SDK.

4. 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)

   C#

   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 at twilio.com/console
   11
           // Provision API Keys at twilio.com/console/runtime/api-keys
   12
           // and set the environment variables. See http://twil.io/secure
   13
           // For local testing, you can use your Account SID and Auth token
   14
           string apiKey = Environment.GetEnvironmentVariable("TWILIO_API_KEY");
   15
           string apiSecret = Environment.GetEnvironmentVariable("TWILIO_API_SECRET");
   16
           string accountSid = Environment.GetEnvironmentVariable("TWILIO_ACCOUNT_SID");
   17
   
   18
           TwilioClient.Init(apiKey, apiSecret, accountSid);
   19
   
   20
           var message = await MessageResource.CreateAsync(
   21
               body: "Join Earth's mightiest heroes. Like Kevin Bacon.",
   22
               from: new Twilio.Types.PhoneNumber("+15017122661"),
   23
               to: new Twilio.Types.PhoneNumber("+15558675310"));
   24
   
   25
           Console.WriteLine(message.Body);
   26
       }
   27
   }

   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).

5. 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: https://www.twilio.com/console
   4
           // Create API keys: https://www.twilio.com/docs/iam/api-keys/keys-in-console
   5
           // and set the environment variables. See https://twil.io/secure
   6
           string accountSid = Environment.GetEnvironmentVariable("TWILIO_ACCOUNT_SID");
   7
           var apiKey = Environment.GetEnvironmentVariable("TWILIO_API_KEY");
   8
           var apiSecret = Environment.GetEnvironmentVariable("TWILIO_API_SECRET");
   9
   
   10
           TwilioClient.Init(apiKey, apiSecret, accountSid);
   11
   
   12
           string[] numbers = { "+15558675310", "+12345678901", "+10987654321" };
   13
   
   14
           foreach (var number in numbers) {
   15
               var message = await MessageResource.CreateAsync(
   16
                   body: "Join Earth's mightiest heroes. Like Kevin Bacon.",
   17
                   from: new Twilio.Types.PhoneNumber("+15017122661"),
   18
                   to: new Twilio.Types.PhoneNumber(number));
   19
   
   20
                Console.WriteLine(message.Body);
   21
           }
   22
       }
   23
   }

   (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.

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

7. 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)

   C#

   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 at twilio.com/console
   11
           // Provision API Keys at twilio.com/console/runtime/api-keys
   12
           // and set the environment variables. See http://twil.io/secure
   13
           // For local testing, you can use your Account SID and Auth token
   14
           string apiKey = Environment.GetEnvironmentVariable("TWILIO_API_KEY");
   15
           string apiSecret = Environment.GetEnvironmentVariable("TWILIO_API_SECRET");
   16
           string accountSid = Environment.GetEnvironmentVariable("TWILIO_ACCOUNT_SID");
   17
   
   18
           TwilioClient.Init(apiKey, apiSecret, accountSid);
   19
   
   20
           var message = await MessageResource.CreateAsync(
   21
               body: "Join Earth's mightiest heroes. Like Kevin Bacon.",
   22
               from: new Twilio.Types.PhoneNumber("+15017122661"),
   23
               to: new Twilio.Types.PhoneNumber("+15558675310"));
   24
   
   25
           Console.WriteLine(message.Body);
   26
       }
   27
   }

   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, API key SID, and API key secret.

   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, SKXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX with your API key SID, and your_api_secret with your API key secret.

      Copy code block

      1
      echo "export TWILIO_ACCOUNT_SID='ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX'" > twilio.env
      2
      echo "export TWILIO_API_KEY='SKXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX'" >> twilio.env
      3
      echo "export TWILIO_API_SECRET='your_api_secret'" >> twilio.env
      4
      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, SKXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX with your API key SID, and your_api_secret with your API key secret.

   Copy code block

   1
   set TWILIO_ACCOUNT_SID=ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
   2
   set TWILIO_API_KEY=SKXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
   3
   set TWILIO_API_SECRET=your_api_secret

   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: https://www.twilio.com/console
   4
           // Create API keys: https://www.twilio.com/docs/iam/api-keys/keys-in-console
   5
           // and set the environment variables. See https://twil.io/secure
   6
           string accountSid = Environment.GetEnvironmentVariable("TWILIO_ACCOUNT_SID");
   7
           var apiKey = Environment.GetEnvironmentVariable("TWILIO_API_KEY");
   8
           var apiSecret = Environment.GetEnvironmentVariable("TWILIO_API_SECRET");
   9
   
   10
           TwilioClient.Init(apiKey, apiSecret, accountSid);
   11
   
   12
           string[] numbers = { "+15558675310", "+12345678901", "+10987654321" };
   13
   
   14
           foreach (var number in numbers) {
   15
               var message = await MessageResource.CreateAsync(
   16
                   body: "Join Earth's mightiest heroes. Like Kevin Bacon.",
   17
                   from: new Twilio.Types.PhoneNumber("+15017122661"),
   18
                   to: new Twilio.Types.PhoneNumber(number));
   19
   
   20
                Console.WriteLine(message.Body);
   21
           }
   22
       }
   23
   }

   (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

   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 at twilio.com/console
   9
       // Provision API Keys at twilio.com/console/runtime/api-keys
   10
       // and set the environment variables. See http://twil.io/secure
   11
       // For local testing, you can use your Account SID and Auth token
   12
       public static final String API_KEY = System.getenv("TWILIO_API_KEY");
   13
       public static final String API_SECRET = System.getenv("TWILIO_API_SECRET");
   14
       public static final String ACCOUNT_SID = System.getenv("TWILIO_ACCOUNT_SID");
   15
   
   16
       public static void main(String[] args) {
   17
           Twilio.init(API_KEY, API_SECRET, ACCOUNT_SID);
   18
           Message message = Message
   19
                                 .creator(new com.twilio.type.PhoneNumber("+15558675310"),
   20
                                     new com.twilio.type.PhoneNumber("+15017122661"),
   21
                                     "This is the ship that made the Kessel Run in fourteen parsecs?")
   22
                                 .create();
   23
   
   24
           System.out.println(message.getBody());
   25
       }
   26
   }

   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, API key SID, and API key secret.

   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, SKXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX with your API key SID, and your_api_secret with your API key secret.

      Copy code block

      1
      echo "export TWILIO_ACCOUNT_SID='ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX'" > twilio.env
      2
      echo "export TWILIO_API_KEY='SKXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX'" >> twilio.env
      3
      echo "export TWILIO_API_SECRET='your_api_secret'" >> twilio.env
      4
      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, SKXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX with your API key SID, and your_api_secret with your API key secret.

   Copy code block

   1
   set TWILIO_ACCOUNT_SID=ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
   2
   set TWILIO_API_KEY=SKXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
   3
   set TWILIO_API_SECRET=your_api_secret

   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(API_KEY, API_SECRET, ACCOUNT_SID);
      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 program. 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 SDK:

      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

   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 at twilio.com/console
   13
   	// Provision API Keys at twilio.com/console/runtime/api-keys
   14
   	// and set the environment variables. See http://twil.io/secure
   15
   	// For local testing, you can use your Account SID and Auth token
   16
   	accountSid := os.Getenv("TWILIO_ACCOUNT_SID")
   17
   	apiKey := os.Getenv("TWILIO_API_KEY")
   18
   	apiSecret := os.Getenv("TWILIO_API_SECRET")
   19
   	client := twilio.NewRestClientWithParams(twilio.ClientParams{
   20
   		Username:   apiKey,
   21
   		Password:   apiSecret,
   22
   		AccountSid: accountSid,
   23
   	})
   24
   
   25
   	params := &api.CreateMessageParams{}
   26
   	params.SetBody("Join Earth's mightiest heroes. Like Kevin Bacon.")
   27
   	params.SetFrom("+15017122661")
   28
   	params.SetTo("+15558675310")
   29
   
   30
   	resp, err := client.Api.CreateMessage(params)
   31
   	if err != nil {
   32
   		fmt.Println(err.Error())
   33
   		os.Exit(1)
   34
   	} else {
   35
   		if resp.Body != nil {
   36
   			fmt.Println(*resp.Body)
   37
   		} else {
   38
   			fmt.Println(resp.Body)
   39
   		}
   40
   	}
   41
   }

   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, API key SID, and API key secret.

   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, SKXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX with your API key SID, and your_api_secret with your API key secret.

      Copy code block

      1
      echo "export TWILIO_ACCOUNT_SID='ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX'" > twilio.env
      2
      echo "export TWILIO_API_KEY='SKXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX'" >> twilio.env
      3
      echo "export TWILIO_API_SECRET='your_api_secret'" >> twilio.env
      4
      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, SKXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX with your API key SID, and your_api_secret with your API key secret.

   Copy code block

   1
   set TWILIO_ACCOUNT_SID=ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
   2
   set TWILIO_API_KEY=SKXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
   3
   set TWILIO_API_SECRET=your_api_secret

   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

   Ruby

   Report code block

   Copy code block

   1
   # Download the helper library from https://www.twilio.com/docs/ruby/install
   2
   require 'twilio-ruby'
   3
   
   4
   # Find your Account SID at twilio.com/console
   5
   # Provision API Keys at twilio.com/console/runtime/api-keys
   6
   # and set the environment variables. See http://twil.io/secure
   7
   # For local testing, you can use your Account SID and Auth token
   8
   api_key = ENV['TWILIO_API_KEY']
   9
   api_secret = ENV['TWILIO_API_SECRET']
   10
   account_sid = ENV['TWILIO_ACCOUNT_SID']
   11
   @client = Twilio::REST::Client.new(api_key, api_secret, account_sid)
   12
   
   13
   message = @client
   14
             .api
   15
             .v2010
   16
             .messages
   17
             .create(
   18
               body: 'Join Earth\'s mightiest heroes. Like Kevin Bacon.',
   19
               from: '+15017122661',
   20
               to: '+15558675310'
   21
             )
   22
   
   23
   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, API key SID, and API key secret.

   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, SKXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX with your API key SID, and your_api_secret with your API key secret.

      Copy code block

      1
      echo "export TWILIO_ACCOUNT_SID='ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX'" > twilio.env
      2
      echo "export TWILIO_API_KEY='SKXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX'" >> twilio.env
      3
      echo "export TWILIO_API_SECRET='your_api_secret'" >> twilio.env
      4
      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, SKXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX with your API key SID, and your_api_secret with your API key secret.

   Copy code block

   1
   set TWILIO_ACCOUNT_SID=ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
   2
   set TWILIO_API_KEY=SKXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
   3
   set TWILIO_API_SECRET=your_api_secret

   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, API key SID, API key secret, your Twilio phone number in E.164 format, and the recipient's phone number in E.164 format.

   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_API_KEY=xxxxxxxxx
   3
   export TWILIO_API_SECRET=xxxxxxxxx
   4
   export TWILIO_NUMBER=xxxxxxxxx
   5
   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_API_KEY=xxxxxxxxx
   3
   set TWILIO_API_SECRET=xxxxxxxxx
   4
   set TWILIO_NUMBER=xxxxxxxxx
   5
   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.

   Send an SMS message

   curl

   Report code block

   Copy code block

   1
   curl -X POST "https://api.twilio.com/2010-04-01/Accounts/$TWILIO_ACCOUNT_SID/Messages.json" \
   2
   --data-urlencode "Body=Hi there, this is a test message from cURL" \
   3
   --data-urlencode "From=+15017122661" \
   4
   --data-urlencode "To=+15558675310" \
   5
   -u $TWILIO_API_KEY:$TWILIO_API_SECRET

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

   Send an SMS message

   curl

   Report code block

   Copy code block

   1
   curl -X POST "https://api.twilio.com/2010-04-01/Accounts/$TWILIO_ACCOUNT_SID/Messages.json" \
   2
   --data-urlencode "Body=Hi there, this is a test message from cURL" \
   3
   --data-urlencode "From=+15017122661" \
   4
   --data-urlencode "To=+15558675310" \
   5
   -u $TWILIO_API_KEY:$TWILIO_API_SECRET

   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 at twilio.com/console
6
# Provision API Keys at twilio.com/console/runtime/api-keys
7
# and set the environment variables. See http://twil.io/secure
8
# For local testing, you can use your Account SID and Auth token
9
api_key = os.environ["TWILIO_API_KEY"]
10
api_secret = os.environ["TWILIO_API_SECRET"]
11
account_sid = os.environ["TWILIO_ACCOUNT_SID"]
12
client = Client(api_key, api_secret, account_sid)
13

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

23
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 at twilio.com/console
5
// Provision API Keys at twilio.com/console/runtime/api-keys
6
// and set the environment variables. See http://twil.io/secure
7
// For local testing, you can use your Account SID and Auth token
8
const accountSid = process.env.TWILIO_ACCOUNT_SID;
9
const apiKey = process.env.TWILIO_API_KEY;
10
const apiSecret = process.env.TWILIO_API_SECRET;
11
const client = twilio(apiKey, apiSecret, { accountSid: accountSid });
12

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

23
  console.log(message.body);
24
}
25

26
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 at twilio.com/console
10
// Provision API Keys at twilio.com/console/runtime/api-keys
11
// and set the environment variables. See http://twil.io/secure
12
// For local testing, you can use your Account SID and Auth token
13
$apiKey = $_ENV["TWILIO_API_KEY"];
14
$apiSecret = $_ENV["TWILIO_API_SECRET"];
15
$sid = $_ENV["TWILIO_ACCOUNT_SID"];
16
$twilio = new Client($apiKey, $apiSecret, $sid);
17

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

30
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 at twilio.com/console
12
        // Provision API Keys at twilio.com/console/runtime/api-keys
13
        // and set the environment variables. See http://twil.io/secure
14
        // For local testing, you can use your Account SID and Auth token
15
        string apiKey = Environment.GetEnvironmentVariable("TWILIO_API_KEY");
16
        string apiSecret = Environment.GetEnvironmentVariable("TWILIO_API_SECRET");
17
        string accountSid = Environment.GetEnvironmentVariable("TWILIO_ACCOUNT_SID");
18

19
        TwilioClient.Init(apiKey, apiSecret, accountSid);
20

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

28
        Console.WriteLine(message.Body);
29
    }
30
}

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 at twilio.com/console
12
        // Provision API Keys at twilio.com/console/runtime/api-keys
13
        // and set the environment variables. See http://twil.io/secure
14
        // For local testing, you can use your Account SID and Auth token
15
        string apiKey = Environment.GetEnvironmentVariable("TWILIO_API_KEY");
16
        string apiSecret = Environment.GetEnvironmentVariable("TWILIO_API_SECRET");
17
        string accountSid = Environment.GetEnvironmentVariable("TWILIO_ACCOUNT_SID");
18

19
        TwilioClient.Init(apiKey, apiSecret, accountSid);
20

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

28
        Console.WriteLine(message.Body);
29
    }
30
}

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 at twilio.com/console
11
    // Provision API Keys at twilio.com/console/runtime/api-keys
12
    // and set the environment variables. See http://twil.io/secure
13
    // For local testing, you can use your Account SID and Auth token
14
    public static final String API_KEY = System.getenv("TWILIO_API_KEY");
15
    public static final String API_SECRET = System.getenv("TWILIO_API_SECRET");
16
    public static final String ACCOUNT_SID = System.getenv("TWILIO_ACCOUNT_SID");
17

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

28
        System.out.println(message.getBody());
29
    }
30
}

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 at twilio.com/console
13
	// Provision API Keys at twilio.com/console/runtime/api-keys
14
	// and set the environment variables. See http://twil.io/secure
15
	// For local testing, you can use your Account SID and Auth token
16
	accountSid := os.Getenv("TWILIO_ACCOUNT_SID")
17
	apiKey := os.Getenv("TWILIO_API_KEY")
18
	apiSecret := os.Getenv("TWILIO_API_SECRET")
19
	client := twilio.NewRestClientWithParams(twilio.ClientParams{
20
		Username:   apiKey,
21
		Password:   apiSecret,
22
		AccountSid: accountSid,
23
	})
24

25
	params := &api.CreateMessageParams{}
26
	params.SetBody("This is the ship that made the Kessel Run in fourteen parsecs?")
27
	params.SetFrom("+15017122661")
28
	params.SetMediaUrl([]string{
29
		"https://c1.staticflickr.com/3/2899/14341091933_1e92e62d12_b.jpg",
30
	})
31
	params.SetTo("+15558675310")
32

33
	resp, err := client.Api.CreateMessage(params)
34
	if err != nil {
35
		fmt.Println(err.Error())
36
		os.Exit(1)
37
	} else {
38
		if resp.Body != nil {
39
			fmt.Println(*resp.Body)
40
		} else {
41
			fmt.Println(resp.Body)
42
		}
43
	}
44
}

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 'twilio-ruby'
3

4
# Find your Account SID at twilio.com/console
5
# Provision API Keys at twilio.com/console/runtime/api-keys
6
# and set the environment variables. See http://twil.io/secure
7
# For local testing, you can use your Account SID and Auth token
8
api_key = ENV['TWILIO_API_KEY']
9
api_secret = ENV['TWILIO_API_SECRET']
10
account_sid = ENV['TWILIO_ACCOUNT_SID']
11
@client = Twilio::REST::Client.new(api_key, api_secret, account_sid)
12

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

26
puts message.body