Send SMS and MMS Messages in PHP

Before you can receive phone calls and send messages, you'll need to sign up for a Twilio account and purchase a Twilio phone number.

If you're brand new to Twilio, you can sign up for a free trial account to get started. Once you've signed up, head over to your Console and grab your Account SID and your Auth Token. You will need those values for the code samples below.

Sending messages requires a Twilio phone number with SMS capabilities. If you don't currently own a Twilio phone number with SMS capabilities, you'll need to buy one. After navigating to the Buy a Number page, check the 'SMS' box and click 'Search':

Expand image

If you live in the US or Canada and also wish to send MMS messages, you can select the 'MMS' box. When viewing the search results, you can see the capability icons in the list of available numbers:

Expand image

Find a number you like and click "Buy" to add it to your account.

Now that you have a Twilio phone number you can start sending messages to mobile devices.

To send an outgoing SMS message from your Twilio account, you'll need to make an HTTP POST to Twilio's Message resource.

Using the Twilio PHP Helper Library, you can create a new instance of the Message resource and specify the To, From, and Body parameters for your message.

If you don't already have the PHP Helper Library installed, you can install it using Composer. If you need to install Composer, follow these instructions for your platform:

• Install Composer for Mac OSX, Linux, or Unix
• Install Composer for Windows

There are two ways to install the PHP Helper library - which is easier depends on your platform.

From a terminal, you can run the following command in your project directory:

composer require twilio/sdk

Alternatively, you can create a file named composer.json. In that file, add:

1
{
2
    "require": {
3
        "twilio/sdk": "^5.0"
4
    }
5
}

Then run

composer install

Next, open a file named send-sms.php. Paste in the following content:

1
<?php
2

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

7
use Twilio\Rest\Client;
8

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

15
$message = $twilio->messages->create(
16
    "+15558675310", // To
17
    [
18
        "body" =>
19
            "This is the ship that made the Kessel Run in fourteen parsecs?",
20
        "from" => "+15017122661",
21
    ]
22
);
23

24
print $message->body;

1
{
2
  "account_sid": "ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
3
  "api_version": "2010-04-01",
4
  "body": "This is the ship that made the Kessel Run in fourteen parsecs?",
5
  "date_created": "Thu, 30 Jul 2015 20:12:31 +0000",
6
  "date_sent": "Thu, 30 Jul 2015 20:12:33 +0000",
7
  "date_updated": "Thu, 30 Jul 2015 20:12:33 +0000",
8
  "direction": "outbound-api",
9
  "error_code": null,
10
  "error_message": null,
11
  "from": "+15017122661",
12
  "messaging_service_sid": "MGaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
13
  "num_media": "0",
14
  "num_segments": "1",
15
  "price": null,
16
  "price_unit": null,
17
  "sid": "SMaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
18
  "status": "queued",
19
  "subresource_uris": {
20
    "media": "/2010-04-01/Accounts/ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Messages/SMaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Media.json"
21
  },
22
  "tags": null,
23
  "to": "+15558675310",
24
  "uri": "/2010-04-01/Accounts/ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Messages/SMaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa.json"
25
}

Replace the placeholder values for sid and token with your unique values for Account SID and Auth Token. You can find these in your Twilio console.

You'll tell Twilio which phone number to use to send this message by replacing the from number with the Twilio phone number you purchased earlier. In the line with the // to comment (line 11 in our sample code), put the recipient number (likely your cell phone number).

Both of these parameters must use E.164 formatting ("+" and a country code, e.g., +16175551212)

Once you've updated the code, save it. You can then run it from the command line:

php send-sms.php

Then you should quickly see a blinking or beeping phone with the SMS - neat!

Let's take a moment to understand what's going on behind the scenes when you send this request to Twilio.

When Twilio receives your request to send an SMS via the REST API, it will check that you've included a valid Twilio phone number in the from field. Twilio will then either queue the SMS or return this HTTP error in its response to your request.

Expand image

Assuming your request didn't result in any errors, Twilio's HTTP response will include the SID of the new message. This unique identifier will help us reference this message later: in the code above, we printed that SID to the terminal.

Twilio's JSON response includes a robust amount of data about your message. A sample response might look like this:

1
{
2
  "sid": "SMxxxxxxxxxxxxxxx",
3
  "date_created": "Thu, 09 Aug 2018 17:26:08 +0000",
4
  "date_updated": "Thu, 09 Aug 2018 17:26:08 +0000",
5
  "date_sent": null,
6
  "account_sid": "ACxxxxxxxxxxxxxxxx",
7
  "to": "+15558675310",
8
  "from": "+15017122661",
9
  "messaging_service_sid": "MGXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
10
  "body": "This is the ship that made the Kessel Run in fourteen parsecs?",
11
  "status": "queued",
12
  "num_segments": "1",
13
  "num_media": "0",
14
  "direction": "outbound-api",
15
  "api_version": "2010-04-01",
16
  "price": null,
17
  "price_unit": "USD",
18
  "error_code": null,
19
  "error_message": null,
20
  "uri": "/2010-04-01/Accounts/ACxxxxxxxxx/Messages/SMxxxxxxxxxxxx.json",
21
  "subresource_uris": {
22
      "media": "/2010-04-01/Accounts/ACxxxxxxxx/Messages/SMxxxxxxxxxxxxx/Media.json"
23
  }
24
}
25

You can access any of these attributes from your PHP code, much like we did when we printed the sid.

Try adding a print statement like print($message->status);. Save the file, then run the code with php send-sms.php one more time. You should see the status of your message, "queued", printed to your terminal.

If you receive an error in response from Twilio or never receive the message, you may want to check out these tips for troubleshooting undelivered messages.

1
{
2
  "sid": "SMxxxxxxxxxxxxxxx",
3
  "date_created": "Thu, 09 Aug 2018 17:26:08 +0000",
4
  "date_updated": "Thu, 09 Aug 2018 17:26:08 +0000",
5
  "date_sent": null,
6
  "account_sid": "ACxxxxxxxxxxxxxxxx",
7
  "to": "+15558675310",
8
  "from": "+15017122661",
9
  "messaging_service_sid": "MGXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
10
  "body": "This is the ship that made the Kessel Run in fourteen parsecs?",
11
  "status": "queued",
12
  "num_segments": "1",
13
  "num_media": "0",
14
  "direction": "outbound-api",
15
  "api_version": "2010-04-01",
16
  "price": null,
17
  "price_unit": "USD",
18
  "error_code": null,
19
  "error_message": null,
20
  "uri": "/2010-04-01/Accounts/ACxxxxxxxxx/Messages/SMxxxxxxxxxxxx.json",
21
  "subresource_uris": {
22
      "media": null
23
  }
24
}
25

To send more than one message, call:

$twilio->messages->create(...

in a loop - there is no need for you to add a delay in your logic. You can send as many messages as you'd like as quickly as you can and Twilio will queue them up for delivery at your prescribed rate limit. This will create a new Message instance for each phone number in the list.

You may find that it's helpful to organize your account and message logs into separate Messaging Services. See our guide on how to set up and send messages from a messaging service for more tips.

To include media in your Twilio-powered text message, you need to make one small addition to the code we wrote above. To send an MMS, you will still make an HTTP POST request to the Message resource but this time specify a parameter for the URL of media, such as an image.

Create a file called send-mms.php and include the following code:

1
<?php
2

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

7
use Twilio\Rest\Client;
8

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

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

27
print $message->body;

1
{
2
  "account_sid": "ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
3
  "api_version": "2010-04-01",
4
  "body": "This is the ship that made the Kessel Run in fourteen parsecs?",
5
  "date_created": "Thu, 24 Aug 2023 05:01:45 +0000",
6
  "date_sent": "Thu, 24 Aug 2023 05:01:45 +0000",
7
  "date_updated": "Thu, 24 Aug 2023 05:01:45 +0000",
8
  "direction": "outbound-api",
9
  "error_code": null,
10
  "error_message": null,
11
  "from": "+15017122661",
12
  "num_media": "0",
13
  "num_segments": "1",
14
  "price": null,
15
  "price_unit": null,
16
  "messaging_service_sid": "MGaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
17
  "sid": "SMaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
18
  "status": "queued",
19
  "subresource_uris": {
20
    "media": "/2010-04-01/Accounts/ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Messages/SMaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Media.json"
21
  },
22
  "tags": {
23
    "campaign_name": "Spring Sale 2022",
24
    "message_type": "cart_abandoned"
25
  },
26
  "to": "+15558675310",
27
  "uri": "/2010-04-01/Accounts/ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Messages/SMaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa.json"
28
}

Again, update the from and // to commented line to use your Twilio phone number and your mobile phone.

The new mediaUrl parameter in this code tells Twilio where to go to fetch our included image. This must be a publicly accessible URL: Twilio will not be able to reach any URLs that are hidden or require authentication.

As when you send an SMS, Twilio will send data about the message in its response to your request. The JSON response will contain the unique SID and URI for your media resource:

"subresource_uris": {"media": "/2010-04 01/Accounts/ACxxxxxxxx/Messages/SMxxxxxxxxxxxxx/Media.json"}

When the Twilio REST API creates your new Message resource, it will save the image found at the specified media_url as a Media resource. Once created, you can access this resource at any time via the API.

Save the file and run it from the command line:

php send_mms.php

In just a moment you should receive a text message with an image - looks good, right?

Want to build more messaging functionality into your PHP Application? Also, try our PHP SMS Quickstart, and see how to receive and reply to messages in PHP.