Send SMS and MMS messages

In this tutorial, you'll learn to use Twilio Programmable Messaging to programmatically send SMS and Multimedia Messaging Service (MMS) messages using your web application. This tutorial makes HTTP POST requests to the Message resource and the Media resource in the Twilio REST API, using the Twilio helper libraries to simplify requests in your programming language.

To send messages without writing code, use Twilio Studio (our low-code application builder).

Complete the prerequisites

Select your programming language and complete the prerequisites:

PythonNode.jsPHPC# (.NET Framework)C# (.NET Core)JavaGoRuby

Install Python.
Install the Twilio Python module. To install using pip, run:
pip install twilio

Sign up for Twilio.
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.
Complete any applicable verification or registration requirements.
- If you get a toll-free number, you must complete toll-free verification before you can send SMS messages to mobile phones in the US and Canada.
- To send an SMS message from a US 10DLC number to a US recipient, register the Twilio phone number for A2P 10DLC in the Twilio Console. To learn more, see What is A2P 10DLC?.
- To send an SMS message from a UK long code number to a UK recipient, you must submit a Regulatory Compliance (RC) bundle. To learn more, see Know Your Customer (KYC) in the United Kingdom.
While you wait for verification or registration, you can test with the Twilio Virtual Phone. To learn more, see the SMS developer quickstart.

Install Node.js.
Install the Twilio Node.js helper library:
npm install twilio

Sign up for Twilio.
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.
Complete any applicable verification or registration requirements.
- If you get a toll-free number, you must complete toll-free verification before you can send SMS messages to mobile phones in the US and Canada.
- To send an SMS message from a US 10DLC number to a US recipient, register the Twilio phone number for A2P 10DLC in the Twilio Console. To learn more, see What is A2P 10DLC?.
- To send an SMS message from a UK long code number to a UK recipient, you must submit a Regulatory Compliance (RC) bundle. To learn more, see Know Your Customer (KYC) in the United Kingdom.
While you wait for verification or registration, you can test with the Twilio Virtual Phone. To learn more, see the SMS developer quickstart.

Install PHP.
Install dependencies with Composer:
1. Install Composer.
2. Install the Twilio PHP helper library:
  1
  composer require twilio/sdk
  2
  composer install

Sign up for Twilio.
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.
Complete any applicable verification or registration requirements.
- If you get a toll-free number, you must complete toll-free verification before you can send SMS messages to mobile phones in the US and Canada.
- To send an SMS message from a US 10DLC number to a US recipient, register the Twilio phone number for A2P 10DLC in the Twilio Console. To learn more, see What is A2P 10DLC?.
- To send an SMS message from a UK long code number to a UK recipient, you must submit a Regulatory Compliance (RC) bundle. To learn more, see Know Your Customer (KYC) in the United Kingdom.
While you wait for verification or registration, you can test with the Twilio Virtual Phone. To learn more, see the SMS developer quickstart.

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.
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.
Complete any applicable verification or registration requirements.
- If you get a toll-free number, you must complete toll-free verification before you can send SMS messages to mobile phones in the US and Canada.
- To send an SMS message from a US 10DLC number to a US recipient, register the Twilio phone number for A2P 10DLC in the Twilio Console. To learn more, see What is A2P 10DLC?.
- To send an SMS message from a UK long code number to a UK recipient, you must submit a Regulatory Compliance (RC) bundle. To learn more, see Know Your Customer (KYC) in the United Kingdom.
While you wait for verification or registration, you can test with the Twilio Virtual Phone. To learn more, see the SMS developer quickstart.

Install Ruby.
Install the Twilio Ruby helper library:
gem install twilio-ruby

Sign up for Twilio.
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.
Complete any applicable verification or registration requirements.
- If you get a toll-free number, you must complete toll-free verification before you can send SMS messages to mobile phones in the US and Canada.
- To send an SMS message from a US 10DLC number to a US recipient, register the Twilio phone number for A2P 10DLC in the Twilio Console. To learn more, see What is A2P 10DLC?.
- To send an SMS message from a UK long code number to a UK recipient, you must submit a Regulatory Compliance (RC) bundle. To learn more, see Know Your Customer (KYC) in the United Kingdom.
While you wait for verification or registration, you can test with the Twilio Virtual Phone. To learn more, see the SMS developer quickstart.

Send an SMS message

Follow these steps to send an SMS message from your Twilio phone number.

PythonNode.jsPHPC# (.NET Framework)C# (.NET Core)JavaGoRuby

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
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).
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.
  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:
  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.
1
set TWILIO_ACCOUNT_SID=ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
2
set TWILIO_AUTH_TOKEN=your_auth_token
To learn more, see Store your Twilio credentials safely.
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.
  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.
  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.
Replace the value for from with your Twilio phone number in E.164 format.
Save your changes and run this command from your terminal in the directory that contains send_message.py:
python send_message.py
After a few moments, you receive an SMS from your Twilio number.

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

1// Download the helper library from https://www.twilio.com/docs/node/install
2const 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
6const accountSid = process.env.TWILIO_ACCOUNT_SID;
7const authToken = process.env.TWILIO_AUTH_TOKEN;
8const client = twilio(accountSid, authToken);
9
10async 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
20createMessage();

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

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.
  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:
  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.
1
set TWILIO_ACCOUNT_SID=ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
2
set TWILIO_AUTH_TOKEN=your_auth_token
To learn more, see Store your Twilio credentials safely.
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.
  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.
  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.
Replace the value for from with your Twilio phone number in E.164 format.
Save your changes and run this command from your terminal in the directory that contains send_message.js:
node send_message.js
After a few moments, you receive an SMS from your Twilio number.

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

1<?php
2
3// Update the path below to your autoload.php,
4// see https://getcomposer.org/doc/01-basic-usage.md
5require_once "/path/to/vendor/autoload.php";
6
7use 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
24print $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).

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.
  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:
  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.
1
set TWILIO_ACCOUNT_SID=ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
2
set TWILIO_AUTH_TOKEN=your_auth_token
To learn more, see Store your Twilio credentials safely.
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.
  $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.
  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.
Replace the value for from with your Twilio phone number in E.164 format.
Update line 5 of send_message.php to require __DIR__ . '/vendor/autoload.php';
Save your changes and run this command from your terminal in the directory that contains send_message.php:
php send_message.php
After a few moments, you receive an SMS from your Twilio number.

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

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)

1// Install the C# / .NET helper library from twilio.com/docs/csharp/install
2
3using System;
4using Twilio;
5using Twilio.Rest.Api.V2010.Account;
6using System.Threading.Tasks;
7
8class 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).

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.

1class 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 http://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.

Replace the value for from: new Twilio.Types.PhoneNumber with your Twilio phone number in E.164 format.
Save your changes and run your project in Visual Studio.

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

Run the following commands to create a new .NET project and install the Twilio NuGet package:
1
mkdir TwilioSend
2
cd TwilioSend
3
dotnet new console
4
dotnet add package Twilio

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)

1// Install the C# / .NET helper library from twilio.com/docs/csharp/install
2
3using System;
4using Twilio;
5using Twilio.Rest.Api.V2010.Account;
6using System.Threading.Tasks;
7
8class 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}

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.
  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:
  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.
1
set TWILIO_ACCOUNT_SID=ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
2
set TWILIO_AUTH_TOKEN=your_auth_token
To learn more, see Store your Twilio credentials safely.

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

1class 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 http://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.

Replace the value for from: new Twilio.Types.PhoneNumber with your Twilio phone number in E.164 format.
Save your changes and run this command in the directory that contains Program.cs:
dotnet run
After a few moments, you receive an SMS from your Twilio number.

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

1// Install the Java helper library from twilio.com/docs/java/install
2
3import com.twilio.type.PhoneNumber;
4import com.twilio.Twilio;
5import com.twilio.rest.api.v2010.account.Message;
6
7public 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).

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.
  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:
  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.
1
set TWILIO_ACCOUNT_SID=ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
2
set TWILIO_AUTH_TOKEN=your_auth_token
To learn more, see Store your Twilio credentials safely.
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.
  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.
Replace the value for the second new PhoneNumber() with your Twilio phone number in E.164 format.
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.
javac -cp twilio-10.9.0-jar-with-dependencies.jar Example.java
Run the Java. Replace 10.9.0 with the version of your fat jar file. On Linux or macOS, run:
java -cp .:twilio-10.9.0-jar-with-dependencies.jar Example
On Windows, run:
java -cp ".;twilio-10.9.0-jar-with-dependencies.jar" Example
After a few moments, you receive an SMS from your Twilio number.

Create and set up your Go project.
1. Create a new Go project by running the following command:
  go mod init twilio-example
2. Install the Twilio Go helper library:
  go get github.com/twilio/twilio-go

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

1// Download the helper library from https://www.twilio.com/docs/go/install
2package main
3
4import (
5	"fmt"
6	"github.com/twilio/twilio-go"
7	api "github.com/twilio/twilio-go/rest/api/v2010"
8	"os"
9)
10
11func 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).

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.
  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:
  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.
1
set TWILIO_ACCOUNT_SID=ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
2
set TWILIO_AUTH_TOKEN=your_auth_token
To learn more, see Store your Twilio credentials safely.
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.
  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.
  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.
Replace the value for params.SetFrom with your Twilio phone number in E.164 format.
Save your changes and run this command in the directory that contains send_message.go:
go run send_message.go
After a few moments, you receive an SMS from your Twilio number.

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

1# Download the helper library from https://www.twilio.com/docs/ruby/install
2require 'rubygems'
3require '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
7account_sid = ENV['TWILIO_ACCOUNT_SID']
8auth_token = ENV['TWILIO_AUTH_TOKEN']
9@client = Twilio::REST::Client.new(account_sid, auth_token)
10
11message = @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
21puts 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).

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.
  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:
  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.
1
set TWILIO_ACCOUNT_SID=ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
2
set TWILIO_AUTH_TOKEN=your_auth_token
To learn more, see Store your Twilio credentials safely.
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.
  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.
  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.
Replace the value for from with your Twilio phone number in E.164 format.
Save your changes and run this command from your terminal in the directory that contains send_message.rb:
ruby send_message.rb
After a few moments, you receive an SMS from your Twilio number.

Send an MMS message

(information)

Info

To learn which countries support MMS messages, see Sending and receiving MMS messages.

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.

PythonNode.jsPHPC# (.NET Framework)C# (.NET Core)JavaGoRuby

Set the media_url parameter:

Send a Message with an Image URL using Twilio with Python

1# Download the helper library from https://www.twilio.com/docs/python/install
2import os
3from 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
7account_sid = os.environ["TWILIO_ACCOUNT_SID"]
8auth_token = os.environ["TWILIO_AUTH_TOKEN"]
9client = Client(account_sid, auth_token)
10
11message = 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
20print(message.body)

Set the mediaUrl parameter:

Send a Message with an Image URL using Twilio with Node.js

1// Download the helper library from https://www.twilio.com/docs/node/install
2const 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
6const accountSid = process.env.TWILIO_ACCOUNT_SID;
7const authToken = process.env.TWILIO_AUTH_TOKEN;
8const client = twilio(accountSid, authToken);
9
10async 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
23createMessage();

Set the mediaUrl parameter:

Send a Message with an Image URL using Twilio with PHP

1<?php
2
3// Update the path below to your autoload.php,
4// see https://getcomposer.org/doc/01-basic-usage.md
5require_once "/path/to/vendor/autoload.php";
6
7use 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
27print $message->body;

Set the mediaUrl parameter:

Send a Message with an Image URL using Twilio with C#

1// Install the C# / .NET helper library from twilio.com/docs/csharp/install
2
3using System;
4using Twilio;
5using Twilio.Rest.Api.V2010.Account;
6using System.Threading.Tasks;
7using System.Collections.Generic;
8
9class 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}

Set the mediaUrl parameter:

Send a Message with an Image URL using Twilio with C#

1// Install the C# / .NET helper library from twilio.com/docs/csharp/install
2
3using System;
4using Twilio;
5using Twilio.Rest.Api.V2010.Account;
6using System.Threading.Tasks;
7using System.Collections.Generic;
8
9class 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}

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

Send a Message with an Image URL using Twilio with Java

1// Install the Java helper library from twilio.com/docs/java/install
2
3import com.twilio.type.PhoneNumber;
4import java.net.URI;
5import java.util.Arrays;
6import com.twilio.Twilio;
7import com.twilio.rest.api.v2010.account.Message;
8
9public 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}

Add the params.SetMediaUrl() statement:

Send a Message with an Image URL using Twilio with Go

1// Download the helper library from https://www.twilio.com/docs/go/install
2package main
3
4import (
5	"fmt"
6	"github.com/twilio/twilio-go"
7	api "github.com/twilio/twilio-go/rest/api/v2010"
8	"os"
9)
10
11func 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}

Set the media_url parameter:

Send a Message with an Image URL using Twilio with Ruby

1# Download the helper library from https://www.twilio.com/docs/ruby/install
2require 'rubygems'
3require '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
7account_sid = ENV['TWILIO_ACCOUNT_SID']
8auth_token = ENV['TWILIO_AUTH_TOKEN']
9@client = Twilio::REST::Client.new(account_sid, auth_token)
10
11message = @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
24puts message.body

Next steps

View more Messaging tutorials
Sending high-volume messages? Learn more about messaging services
Browse the following developer resources:
- Messaging API Reference
- TwiML documentation

Send SMS and MMS messages

Complete the prerequisites

Send an SMS message

Improve security with API keys

Limits on message cadence

Improve security with API keys

Limits on message cadence

Improve security with API keys

Limits on message cadence

Improve security with API keys

Limits on message cadence

Improve security with API keys

Limits on message cadence

Improve security with API keys

Limits on message cadence

Improve security with API keys

Limits on message cadence

Improve security with API keys

Limits on message cadence

Send an MMS message

Info

Next steps