Make outbound phone calls

Learn to make and manage outbound phone calls with Twilio Programmable Voice by sending a POST request to the Calls resource in the Twilio Voice API. You can use this guide to send notifications and build outbound call centers.

To learn more about the Calls resource used in this guide, see Related reference documentation.

All Programmable Voice feature basics guides

Complete the prerequisites

PythonNode.jsPHPC# (.NET Core)JavaGoRuby

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

pip install twilio

Sign up for Twilio and get a phone number:
1. Sign up for Twilio.
2. To get a phone that has voice capabilities, do either of the following in the Twilio Console:
  - In the Account Dashboard, click Get a phone number.
  - In the navigation menu, go to Phone Numbers > Manage > Buy a number.
3. In the Account Dashboard, copy your Account SID and paste it in a temporary local file for use later in this quickstart.
4. Create an API key, then copy the SID and Secret into the same file.

Install Node.js.
Install the Twilio Node.js SDK:

npm install twilio

Sign up for Twilio and get a phone number:
1. Sign up for Twilio.
2. To get a phone that has voice capabilities, do either of the following in the Twilio Console:
  - In the Account Dashboard, click Get a phone number.
  - In the navigation menu, go to Phone Numbers > Manage > Buy a number.
3. In the Account Dashboard, copy your Account SID and paste it in a temporary local file for use later in this quickstart.
4. Create an API key, then copy the SID and Secret into the same file.

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

Sign up for Twilio and get a phone number:
1. Sign up for Twilio.
2. To get a phone that has voice capabilities, do either of the following in the Twilio Console:
  - In the Account Dashboard, click Get a phone number.
  - In the navigation menu, go to Phone Numbers > Manage > Buy a number.
3. In the Account Dashboard, copy your Account SID and paste it in a temporary local file for use later in this quickstart.
4. Create an API key, then copy the SID and Secret into the same file.

Install Ruby.
Install the Twilio Ruby SDK:

gem install twilio-ruby

Sign up for Twilio and get a phone number:
1. Sign up for Twilio.
2. To get a phone that has voice capabilities, do either of the following in the Twilio Console:
  - In the Account Dashboard, click Get a phone number.
  - In the navigation menu, go to Phone Numbers > Manage > Buy a number.
3. In the Account Dashboard, copy your Account SID and paste it in a temporary local file for use later in this quickstart.
4. Create an API key, then copy the SID and Secret into the same file.

Make an outbound call

PythonNode.jsPHPC# (.NET Core)JavaGoRuby

Create and open a new file called make_call.py anywhere on your machine and paste in the following code:
Make an outbound call with TwiML
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
call = client.calls.create(
15
twiml="<Response><Say>Ahoy, World</Say></Response>",
16
to="+14158675309",
17
from_="+14158675308",
18
)
19

20
print(call.sid)
To learn all of the API response values that you can return with print(), see the response for Create a call in the API documentation. Precede the response value with call. (for example: print(call.sid) returns the sid value).
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.
  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
  1. 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, SKXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX with your API key SID, and your_api_secret with your API key secret.
  1
  set TWILIO_ACCOUNT_SID=ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
  2
  set TWILIO_API_KEY=SKXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
  3
  set TWILIO_API_SECRET=your_api_secret
Learn more about storing your Twilio credentials safely.
In the make_call.py file, do the following:
- Replace the value for to with the recipient phone number in E.164 format.
- Replace the value for from with your Twilio phone number in E.164 format.
- Replace the value for twiml with your desired TwiML instructions.
  - To use a hosted TwiML URL, replace twiml with url and set the value to the URL that hosts your TwiML instructions. For example:
    url="http://demo.twilio.com/docs/voice.xml"
    The following voice.xml file is hosted at http://demo.twilio.com/docs/voice.xml uses the <Say> and the <Play> TwiML tags to read a message and play an MP3 file for the user.
    1
    <?xml version="1.0" encoding="UTF-8"?>
    2
    <Response>
    3
    <Say voice="Polly.Joanna-Generative">Thanks for trying our documentation. Enjoy!</Say>
    4
    <Play>http://demo.twilio.com/docs/classic.mp3</Play>
    5
    </Response>
    6
    </xml>
  - To use a TwiML application to handle calls, replace twiml with application_sid and set the value to your TwiML application's SID. You can create and configure applications on the TwiML apps page in Console (Develop > TwiML apps). If you're using legacy Console, go to Voice > Manage > TwiML apps.
    application_sid="<YOUR_TWIML_APP_SID>"
    When your outbound call is connected, Twilio will make a request to the Voice URL set on your application.
    
    (warning)
    Warning
    The application_sid take precedence over the twiml and url parameters and ignores the following parameters: method, fallback_url, fallback_method, status_callback, status_callback_method. Twilio expects that your application handles all of this information. Learn more about the Calls resource.
Save your changes and run this command from your terminal in the directory that contains make_call.py:
python make_call.py

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

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

Make an outbound call with TwiML

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 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
8const accountSid = process.env.TWILIO_ACCOUNT_SID;
9const apiKey = process.env.TWILIO_API_KEY;
10const apiSecret = process.env.TWILIO_API_SECRET;
11const client = twilio(apiKey, apiSecret, { accountSid: accountSid });
12
13async function createCall() {
14  const call = await client.calls.create({
15    from: "+14158675308",
16    to: "+14158675309",
17    twiml: "<Response><Say>Ahoy, World</Say></Response>",
18  });
19
20  console.log(call.sid);
21}
22
23createCall();

To learn all of the API response values that you can return with console.log(), see the response for Create a call in the API documentation. Precede the response value with call. (for example: console.log(call.sid) returns the sid value).

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.
  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
  1. 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, SKXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX with your API key SID, and your_api_secret with your API key secret.
  1
  set TWILIO_ACCOUNT_SID=ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
  2
  set TWILIO_API_KEY=SKXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
  3
  set TWILIO_API_SECRET=your_api_secret
Learn more about storing your Twilio credentials safely.
In the make_call.js file, do the following:
- Replace the value for to with the recipient phone number in E.164 format.
- Replace the value for from with your Twilio phone number in E.164 format.
- Replace the value for twiml with your desired TwiML instructions.
  - To use a hosted TwiML URL, replace twiml with url and set the value to the URL that hosts your TwiML instructions. For example:
    url="http://demo.twilio.com/docs/voice.xml"
    The following voice.xml file is hosted at http://demo.twilio.com/docs/voice.xml uses the <Say> and the <Play> TwiML tags to read a message and play an MP3 file for the user.
    1
    <?xml version="1.0" encoding="UTF-8"?>
    2
    <Response>
    3
    <Say voice="Polly.Joanna-Generative">Thanks for trying our documentation. Enjoy!</Say>
    4
    <Play>http://demo.twilio.com/docs/classic.mp3</Play>
    5
    </Response>
    6
    </xml>
  - To use a TwiML application to handle calls, replace twiml with applicationSid and set the value to your TwiML application's SID. You can create and configure applications on the TwiML apps page in Console (Develop > TwiML apps). If you're using legacy Console, go to Voice > Manage > TwiML apps.
    applicationSid="<YOUR_TWIML_APP_SID>"
    When your outbound call is connected, Twilio will make a request to the Voice URL set on your application.
    
    (warning)
    Warning
    The applicationSid take precedence over the twiml and url parameters and ignores the following parameters: method, fallbackUrl, fallbackMethod, statusCallback, statusCallbackMethod. Twilio expects that your application handles all of this information. Learn more about the Calls resource.
Save your changes and run this command from your terminal in the directory that contains make_call.js:
node make_call.js

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

Create and open a new file called make_call.php anywhere on your machine and paste in the following code:

Make an outbound call with TwiML

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 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$call = $twilio->calls->create(
19    "+14158675309", // To
20    "+14158675308", // From
21    ["twiml" => "<Response><Say>Ahoy, World</Say></Response>"],
22);
23
24print $call->sid;

To learn all of the API response values that you can return with print, see the response for Create a call in the API documentation. Precede the response value with $call-> (for example: print($call->sid) returns the sid value).

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.
  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
  1. 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, SKXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX with your API key SID, and your_api_secret with your API key secret.
  1
  set TWILIO_ACCOUNT_SID=ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
  2
  set TWILIO_API_KEY=SKXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
  3
  set TWILIO_API_SECRET=your_api_secret
Learn more about storing your Twilio credentials safely.
In the make_call.php file, do the following:
- Replace +14155551212 with the recipient phone number in E.164 format.
- Replace +15017122661 with your Twilio phone number in E.164 format.
- Replace the value for twiml with your desired TwiML instructions.
  - To use a hosted TwiML URL, replace twiml with url and set the value to the URL that hosts your TwiML instructions. For example:
    url="http://demo.twilio.com/docs/voice.xml"
    The following voice.xml file is hosted at http://demo.twilio.com/docs/voice.xml uses the <Say> and the <Play> TwiML tags to read a message and play an MP3 file for the user.
    1
    <?xml version="1.0" encoding="UTF-8"?>
    2
    <Response>
    3
    <Say voice="Polly.Joanna-Generative">Thanks for trying our documentation. Enjoy!</Say>
    4
    <Play>http://demo.twilio.com/docs/classic.mp3</Play>
    5
    </Response>
    6
    </xml>
  - To use a TwiML application to handle calls, replace twiml with applicationSid and set the value to your TwiML application's SID. You can create and configure applications on the TwiML apps page in Console (Develop > TwiML apps). If you're using legacy Console, go to Voice > Manage > TwiML apps.
    applicationSid="<YOUR_TWIML_APP_SID>"
    When your outbound call is connected, Twilio will make a request to the Voice URL set on your application.
    
    (warning)
    Warning
    The applicationSid take precedence over the twiml and url parameters and ignores the following parameters: method, fallbackUrl, fallbackMethod, statusCallback, statusCallbackMethod. Twilio expects that your application handles all of this information. Learn more about the Calls resource.
- Update line 5 of make_call.php to require __DIR__ . '/vendor/autoload.php';
Save your changes and run this command from your terminal in the directory that contains make_call.php:
php make_call.php

After a few moments, you'll receive a call from your Twilio number.

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

Open the Program.cs file in your favorite text editor and replace its contents with the following code:

Make an outbound call with TwiML

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 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 call = await CallResource.CreateAsync(
21            twiml: new Twilio.Types.Twiml("<Response><Say>Ahoy, World</Say></Response>"),
22            to: new Twilio.Types.PhoneNumber("+14158675309"),
23            from: new Twilio.Types.PhoneNumber("+14158675308"));
24
25        Console.WriteLine(call.Sid);
26    }
27}

To learn all of the API response values that you can return with Console.WriteLine(), see the response for Create a call in the API documentation. Precede the response value with call. (for example: Console.WriteLine(call.Sid) returns the sid value).

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.
  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
  1. 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, SKXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX with your API key SID, and your_api_secret with your API key secret.
  1
  set TWILIO_ACCOUNT_SID=ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
  2
  set TWILIO_API_KEY=SKXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
  3
  set TWILIO_API_SECRET=your_api_secret
Learn more about storing your Twilio credentials safely.
In the Program.cs file, do the following:
- Replace the value for to with the recipient phone number in E.164 format.
- Replace the value for from with your Twilio phone number in E.164 format.
- Replace the value for twiml with your desired TwiML instructions.
  - To use a hosted TwiML URL, replace twiml with url and set the value to the URL that hosts your TwiML instructions. For example:
    url: new Uri("http://demo.twilio.com/docs/voice.xml")
    The following voice.xml file is hosted at http://demo.twilio.com/docs/voice.xml uses the <Say> and the <Play> TwiML tags to read a message and play an MP3 file for the user.
    1
    <?xml version="1.0" encoding="UTF-8"?>
    2
    <Response>
    3
    <Say voice="Polly.Joanna-Generative">Thanks for trying our documentation. Enjoy!</Say>
    4
    <Play>http://demo.twilio.com/docs/classic.mp3</Play>
    5
    </Response>
    6
    </xml>
  - To use a TwiML application to handle calls, replace twiml with applicationSid and set the value to your TwiML application's SID. You can create and configure applications on the TwiML apps page in Console (Develop > TwiML apps). If you're using legacy Console, go to Voice > Manage > TwiML apps.
    applicationSid: "<YOUR_TWIML_APP_SID>"
    When your outbound call is connected, Twilio will make a request to the Voice URL set on your application.
    
    (warning)
    Warning
    The applicationSid take precedence over the twiml and url parameters and ignores the following parameters: method, fallbackUrl, fallbackMethod, statusCallback, statusCallbackMethod. Twilio expects that your application handles all of this information. Learn more about the Calls resource.
Save your changes and run this command from your terminal in the directory that contains Program.cs:
dotnet run

After a few moments, you'll receive a call from your Twilio number.

Run the following commands to create a new Java project using Gradle:

1mkdir make-call
2cd make-call
3gradle init --type basic --dsl groovy --use-defaults
4mkdir -p src/main/java

Replace the contents of the build.gradle file with the following:

1plugins {
2    id 'java'
3    id 'application'
4}
5
6application {
7    mainClass = 'Example'
8}
9
10repositories {
11    mavenCentral()
12}
13
14dependencies {
15    implementation 'com.twilio.sdk:twilio:10.5.2'
16    implementation 'org.slf4j:slf4j-simple:2.0.16'
17    implementation 'com.sparkjava:spark-core:2.9.4'
18}

Create and open a new file called make_call.java in the src/main/java directory and paste in the following code:

Make an outbound call with TwiML

1// Install the Java helper library from twilio.com/docs/java/install
2
3import com.twilio.type.Twiml;
4import com.twilio.Twilio;
5import com.twilio.rest.api.v2010.account.Call;
6
7public 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        Call call = Call.creator(new com.twilio.type.PhoneNumber("+14158675309"),
19                            new com.twilio.type.PhoneNumber("+14158675308"),
20                            new com.twilio.type.Twiml("<Response><Say>Ahoy, World</Say></Response>"))
21                        .create();
22
23        System.out.println(call.getSid());
24    }
25}

To learn all of the API response values that you can return with System.out.println(), see the response for Create a call in the API documentation. Precede the response value with call.get (for example: System.out.println(call.getSid()) returns the sid value).

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.
  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
  1. 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, SKXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX with your API key SID, and your_api_secret with your API key secret.
  1
  set TWILIO_ACCOUNT_SID=ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
  2
  set TWILIO_API_KEY=SKXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
  3
  set TWILIO_API_SECRET=your_api_secret
Learn more about storing your Twilio credentials safely.
In the make_call.java file, do the following:
- Replace the value for to with the recipient phone number in E.164 format.
- Replace the value for from with your Twilio phone number in E.164 format.
- Replace the value for twiml with your desired TwiML instructions.
  - To use a hosted TwiML URL, replace twiml with url and set the value to the URL that hosts your TwiML instructions. For example:
    url = new URI("http://demo.twilio.com/docs/voice.xml");
    The following voice.xml file is hosted at http://demo.twilio.com/docs/voice.xml uses the <Say> and the <Play> TwiML tags to read a message and play an MP3 file for the user.
    1
    <?xml version="1.0" encoding="UTF-8"?>
    2
    <Response>
    3
    <Say voice="Polly.Joanna-Generative">Thanks for trying our documentation. Enjoy!</Say>
    4
    <Play>http://demo.twilio.com/docs/classic.mp3</Play>
    5
    </Response>
    6
    </xml>
  - To use a TwiML application to handle calls, replace twiml with applicationSid and set the value to your TwiML application's SID. You can create and configure applications on the TwiML apps page in Console (Develop > TwiML apps). If you're using legacy Console, go to Voice > Manage > TwiML apps.
    applicationSid = "<YOUR_TWIML_APP_SID>";
    When your outbound call is connected, Twilio will make a request to the Voice URL set on your application.
    
    (warning)
    Warning
    The applicationSid take precedence over the twiml and url parameters and ignores the following parameters: method, fallbackUrl, fallbackMethod, statusCallback, statusCallbackMethod. Twilio expects that your application handles all of this information. Learn more about the Calls resource.
Run this command from your terminal in the directory that contains build.gradle:
gradle run

After a few moments, you'll receive a call from your Twilio number.

Create a new project folder and the Go module:
1
mkdir make-call
2
cd make-call
3
go mod init make-call

Create and open a new file called make_call.go anywhere on your machine and paste in the following code:

Make an outbound call with TwiML

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 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.CreateCallParams{}
26	params.SetTwiml("<Response><Say>Ahoy, World</Say></Response>")
27	params.SetTo("+14158675309")
28	params.SetFrom("+14158675308")
29
30	resp, err := client.Api.CreateCall(params)
31	if err != nil {
32		fmt.Println(err.Error())
33		os.Exit(1)
34	} else {
35		if resp.Sid != nil {
36			fmt.Println(*resp.Sid)
37		} else {
38			fmt.Println(resp.Sid)
39		}
40	}
41}

To learn all of the API response values that you can return with fmt.Println(), see the response for Create a call in the API documentation. Precede the response value with call. (for example: fmt.Println(call.Sid) returns the sid value).

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.
  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
  1. 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, SKXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX with your API key SID, and your_api_secret with your API key secret.
  1
  set TWILIO_ACCOUNT_SID=ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
  2
  set TWILIO_API_KEY=SKXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
  3
  set TWILIO_API_SECRET=your_api_secret
Learn more about storing your Twilio credentials safely.
In the make_call.go file, do the following:
- Replace the value for To with the recipient phone number in E.164 format.
- Replace the value for From with your Twilio phone number in E.164 format.
- Replace the value for Twiml with your desired TwiML instructions.
  - To use a hosted TwiML URL, replace Twiml with Url and set the value to the URL that hosts your TwiML instructions. For example:
    params.SetUrl("http://demo.twilio.com/docs/voice.xml")
    The following voice.xml file is hosted at http://demo.twilio.com/docs/voice.xml uses the <Say> and the <Play> TwiML tags to read a message and play an MP3 file for the user.
    1
    <?xml version="1.0" encoding="UTF-8"?>
    2
    <Response>
    3
    <Say voice="Polly.Joanna-Generative">Thanks for trying our documentation. Enjoy!</Say>
    4
    <Play>http://demo.twilio.com/docs/classic.mp3</Play>
    5
    </Response>
    6
    </xml>
  - To use a TwiML application to handle calls, replace Twiml with ApplicationSid and set the value to your TwiML application's SID. You can create and configure applications on the TwiML apps page in Console (Develop > TwiML apps). If you're using legacy Console, go to Voice > Manage > TwiML apps.
    params.SetApplicationSid("<YOUR_TWIML_APP_SID>")
    When your outbound call is connected, Twilio will make a request to the Voice URL set on your application.
    
    (warning)
    Warning
    The ApplicationSid take precedence over the Twiml and Url parameters and ignores the following parameters: Method, FallbackUrl, FallbackMethod, StatusCallback, StatusCallbackMethod. Twilio expects that your application handles all of this information. Learn more about the Calls resource.
Save your changes and run this command from your terminal in the directory that contains make_call.go:
1
go get
2
go run make_call.go

After a few moments, you'll receive a call from your Twilio number.

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

Make an outbound call with TwiML

1# Download the helper library from https://www.twilio.com/docs/ruby/install
2require '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
8api_key = ENV['TWILIO_API_KEY']
9api_secret = ENV['TWILIO_API_SECRET']
10account_sid = ENV['TWILIO_ACCOUNT_SID']
11@client = Twilio::REST::Client.new(api_key, api_secret, account_sid)
12
13call = @client
14       .api
15       .v2010
16       .calls
17       .create(
18         twiml: '<Response><Say>Ahoy, World</Say></Response>',
19         to: '+14158675309',
20         from: '+14158675308'
21       )
22
23puts call.sid

To learn all of the API response values that you can return with puts, see the response for Create a call in the API documentation. Precede the response value with call. (for example: puts call.sid returns the sid value).

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.
  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
  1. 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, SKXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX with your API key SID, and your_api_secret with your API key secret.
  1
  set TWILIO_ACCOUNT_SID=ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
  2
  set TWILIO_API_KEY=SKXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
  3
  set TWILIO_API_SECRET=your_api_secret
Learn more about storing your Twilio credentials safely.
In the make_call.rb file, do the following:
- Replace the value for to with the recipient phone number in E.164 format.
- Replace the value for from with your Twilio phone number in E.164 format.
- Replace the value for twiml with your desired TwiML instructions.
  - To use a hosted TwiML URL, replace twiml with url and set the value to the URL that hosts your TwiML instructions. For example:
    url: "http://demo.twilio.com/docs/voice.xml",
    The following voice.xml file is hosted at http://demo.twilio.com/docs/voice.xml uses the <Say> and the <Play> TwiML tags to read a message and play an MP3 file for the user.
    1
    <?xml version="1.0" encoding="UTF-8"?>
    2
    <Response>
    3
    <Say voice="Polly.Joanna-Generative">Thanks for trying our documentation. Enjoy!</Say>
    4
    <Play>http://demo.twilio.com/docs/classic.mp3</Play>
    5
    </Response>
    6
    </xml>
  - To use a TwiML application to handle calls, replace twiml with application_sid and set the value to your TwiML application's SID. You can create and configure applications on the TwiML apps page in Console (Develop > TwiML apps). If you're using legacy Console, go to Voice > Manage > TwiML apps.
    application_sid: "<YOUR_TWIML_APP_SID>",
    When your outbound call is connected, Twilio will make a request to the Voice URL set on your application.
    
    (warning)
    Warning
    The application_sid take precedence over the twiml and url parameters and ignores the following parameters: method, fallback_url, fallback_method, status_callback, status_callback_method. Twilio expects that your application handles all of this information. Learn more about the Calls resource.
Save your changes and run this command from your terminal in the directory that contains make_call.rb:
ruby make_call.rb

After a few moments, you'll receive a call from your Twilio number.

Manage your outbound call

Optionally, you can configure additional parameters when making outbound calls to customize call behavior. Below are some common use cases.

Send digits

To dial an extension, set the SendDigits parameter to the sequence of digits to send after the call connects.

You can include any digit (0-9), A, B, C, D, #, or *.
To add pauses, use w for a half-second pause or W for a one-second pause between digits.

Learn more about the request body parameters.

Make an outbound call and send digits

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 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
8const accountSid = process.env.TWILIO_ACCOUNT_SID;
9const apiKey = process.env.TWILIO_API_KEY;
10const apiSecret = process.env.TWILIO_API_SECRET;
11const client = twilio(apiKey, apiSecret, { accountSid: accountSid });
12
13async function createCall() {
14  const call = await client.calls.create({
15    from: "+14158675308",
16    method: "GET",
17    sendDigits: "1234#",
18    to: "+14158675309",
19    url: "http://demo.twilio.com/docs/voice.xml",
20  });
21
22  console.log(call.sid);
23}
24
25createCall();

Response

1{
2  "account_sid": "ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
3  "answered_by": null,
4  "api_version": "2010-04-01",
5  "caller_name": null,
6  "date_created": "Tue, 31 Aug 2010 20:36:28 +0000",
7  "date_updated": "Tue, 31 Aug 2010 20:36:44 +0000",
8  "direction": "inbound",
9  "duration": "15",
10  "end_time": "Tue, 31 Aug 2010 20:36:44 +0000",
11  "forwarded_from": "+141586753093",
12  "from": "+14158675308",
13  "from_formatted": "(415) 867-5308",
14  "group_sid": null,
15  "parent_call_sid": null,
16  "phone_number_sid": "PNaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
17  "price": "-0.03000",
18  "price_unit": "USD",
19  "sid": "CAaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
20  "start_time": "Tue, 31 Aug 2010 20:36:29 +0000",
21  "status": "completed",
22  "subresource_uris": {
23    "notifications": "/2010-04-01/Accounts/ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Calls/CAaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Notifications.json",
24    "recordings": "/2010-04-01/Accounts/ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Calls/CAaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Recordings.json",
25    "payments": "/2010-04-01/Accounts/ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Calls/CAaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Payments.json",
26    "events": "/2010-04-01/Accounts/ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Calls/CAaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Events.json",
27    "siprec": "/2010-04-01/Accounts/ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Calls/CAaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Siprec.json",
28    "streams": "/2010-04-01/Accounts/ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Calls/CAaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Streams.json",
29    "transcriptions": "/2010-04-01/Accounts/ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Calls/CAaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Transcriptions.json",
30    "user_defined_message_subscriptions": "/2010-04-01/Accounts/ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Calls/CAaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/UserDefinedMessageSubscriptions.json",
31    "user_defined_messages": "/2010-04-01/Accounts/ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Calls/CAaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/UserDefinedMessages.json"
32  },
33  "to": "+14158675309",
34  "to_formatted": "(415) 867-5309",
35  "trunk_sid": null,
36  "uri": "/2010-04-01/Accounts/ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Calls/CAaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa.json",
37  "queue_time": "1000"
38}

Receive call status updates

To receive the outcome of calls, set the StatusCallback parameter to your status callback URL. After Twilio completes your call, it'll make an asynchronous request to the URL. If you don't provide a StatusCallback URL, Twilio will end the call without sending any status updates to your application.

To specify the HTTP request method Twilio should use when making requests to the StatusCallback URL, set the StatusCallbackMethod parameter to either GET or POST. The default is POST.
To specify which call progress events should trigger a request to your StatusCallback URL, set the StatusCallbackEvent parameter to either initiated, ringing, answered, or completed. To specify multiple values, separate them with a space. The default is completed.

Learn more about the StatusCallback and StatusCallbackEvent parameters.

(warning)

Warning

The StatusCallback URL must contain a valid hostname. You can't use underscores.

Set StatusCallback on an outbound call

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 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
8const accountSid = process.env.TWILIO_ACCOUNT_SID;
9const apiKey = process.env.TWILIO_API_KEY;
10const apiSecret = process.env.TWILIO_API_SECRET;
11const client = twilio(apiKey, apiSecret, { accountSid: accountSid });
12
13async function createCall() {
14  const call = await client.calls.create({
15    from: "+14158675308",
16    method: "GET",
17    statusCallback: "https://www.myapp.com/events",
18    statusCallbackEvent: ["completed"],
19    statusCallbackMethod: "POST",
20    to: "+14158675309",
21    url: "http://demo.twilio.com/docs/voice.xml",
22  });
23
24  console.log(call.sid);
25}
26
27createCall();

Response

1{
2  "account_sid": "ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
3  "answered_by": null,
4  "api_version": "2010-04-01",
5  "caller_name": null,
6  "date_created": "Tue, 31 Aug 2010 20:36:28 +0000",
7  "date_updated": "Tue, 31 Aug 2010 20:36:44 +0000",
8  "direction": "inbound",
9  "duration": "15",
10  "end_time": "Tue, 31 Aug 2010 20:36:44 +0000",
11  "forwarded_from": "+141586753093",
12  "from": "+14158675308",
13  "from_formatted": "(415) 867-5308",
14  "group_sid": null,
15  "parent_call_sid": null,
16  "phone_number_sid": "PNaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
17  "price": "-0.03000",
18  "price_unit": "USD",
19  "sid": "CAaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
20  "start_time": "Tue, 31 Aug 2010 20:36:29 +0000",
21  "status": "completed",
22  "subresource_uris": {
23    "notifications": "/2010-04-01/Accounts/ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Calls/CAaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Notifications.json",
24    "recordings": "/2010-04-01/Accounts/ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Calls/CAaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Recordings.json",
25    "payments": "/2010-04-01/Accounts/ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Calls/CAaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Payments.json",
26    "events": "/2010-04-01/Accounts/ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Calls/CAaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Events.json",
27    "siprec": "/2010-04-01/Accounts/ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Calls/CAaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Siprec.json",
28    "streams": "/2010-04-01/Accounts/ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Calls/CAaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Streams.json",
29    "transcriptions": "/2010-04-01/Accounts/ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Calls/CAaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Transcriptions.json",
30    "user_defined_message_subscriptions": "/2010-04-01/Accounts/ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Calls/CAaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/UserDefinedMessageSubscriptions.json",
31    "user_defined_messages": "/2010-04-01/Accounts/ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Calls/CAaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/UserDefinedMessages.json"
32  },
33  "to": "+14158675309",
34  "to_formatted": "(415) 867-5309",
35  "trunk_sid": null,
36  "uri": "/2010-04-01/Accounts/ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Calls/CAaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa.json",
37  "queue_time": "1000"
38}

Record your call

(warning)

Warning

Recording a call is subject to the same obligations and requirements as the Recordings resource and the <Record> TwiML verb. For workflows subject to PCI or the Health Insurance Portability and the Accountability Act (HIPAA), see the applicable documentation.

To record your outbound call, set the Record parameter and set its value to true. You can also configure the following optional parameters to manage your call recordings:

To receive the recording and other information about the call, set the RecordingStatusCallback parameter to a URL that Twilio will request when the recording is available.
To specify the HTTP request method Twilio should use when making requests to the RecordingStatusCallback URL, set the RecordingStatusCallbackMethod parameter to either GET or POST. The default is POST.
To specify which recording status changes should trigger a request to your RecordingStatusCallback URL, set the RecordingStatusCallbackEvent parameter to either completed, absent, or in-progress. To specify multiple values, separate them with a space.

Learn more about the RecordingStatusCallback and RecordingStatusCallbackEvent parameters.

To programmatically pause, resume, or stop recordings, see the Recordings resource and How to record phone calls.

Record an outbound call

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 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
8const accountSid = process.env.TWILIO_ACCOUNT_SID;
9const apiKey = process.env.TWILIO_API_KEY;
10const apiSecret = process.env.TWILIO_API_SECRET;
11const client = twilio(apiKey, apiSecret, { accountSid: accountSid });
12
13async function createCall() {
14  const call = await client.calls.create({
15    from: "+14158675308",
16    record: true,
17    recordingStatusCallback:
18      "https://www.example.com/recording-status-callback",
19    recordingStatusCallbackEvent: ["completed", "in-progress"],
20    recordingStatusCallbackMethod: "POST",
21    to: "+14158675309",
22    url: "http://demo.twilio.com/docs/voice.xml",
23  });
24
25  console.log(call.sid);
26}
27
28createCall();

Response

1{
2  "account_sid": "ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
3  "answered_by": null,
4  "api_version": "2010-04-01",
5  "caller_name": null,
6  "date_created": "Tue, 31 Aug 2010 20:36:28 +0000",
7  "date_updated": "Tue, 31 Aug 2010 20:36:44 +0000",
8  "direction": "inbound",
9  "duration": "15",
10  "end_time": "Tue, 31 Aug 2010 20:36:44 +0000",
11  "forwarded_from": "+141586753093",
12  "from": "+14158675308",
13  "from_formatted": "(415) 867-5308",
14  "group_sid": null,
15  "parent_call_sid": null,
16  "phone_number_sid": "PNaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
17  "price": "-0.03000",
18  "price_unit": "USD",
19  "sid": "CAaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
20  "start_time": "Tue, 31 Aug 2010 20:36:29 +0000",
21  "status": "completed",
22  "subresource_uris": {
23    "notifications": "/2010-04-01/Accounts/ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Calls/CAaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Notifications.json",
24    "recordings": "/2010-04-01/Accounts/ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Calls/CAaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Recordings.json",
25    "payments": "/2010-04-01/Accounts/ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Calls/CAaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Payments.json",
26    "events": "/2010-04-01/Accounts/ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Calls/CAaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Events.json",
27    "siprec": "/2010-04-01/Accounts/ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Calls/CAaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Siprec.json",
28    "streams": "/2010-04-01/Accounts/ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Calls/CAaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Streams.json",
29    "transcriptions": "/2010-04-01/Accounts/ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Calls/CAaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Transcriptions.json",
30    "user_defined_message_subscriptions": "/2010-04-01/Accounts/ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Calls/CAaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/UserDefinedMessageSubscriptions.json",
31    "user_defined_messages": "/2010-04-01/Accounts/ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Calls/CAaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/UserDefinedMessages.json"
32  },
33  "to": "+14158675309",
34  "to_formatted": "(415) 867-5309",
35  "trunk_sid": null,
36  "uri": "/2010-04-01/Accounts/ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Calls/CAaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa.json",
37  "queue_time": "1000"
38}

Use cases for making outbound calls with Twilio Programmable Voice

This guide teaches the basics required for the following use cases:

Send notifications with Twilio Programmable Voice

You can use this guide to programmatically call customers to notify them of important updates, such as appointment reminders, delivery alerts, or emergency notices. Combine outbound calls with the <Say> TwiML verb to play a text-to-speech message, or with the Url parameter to run a custom TwiML workflow when the call connects.

To learn more advanced features that you can use with notifications, see Voice notifications.

Build outbound call centers with Twilio Programmable Voice

You can use this guide as the entry point for dialer and campaign workflows. Programmatically place calls to leads or customers, then use the StatusCallback and Record parameters to track outcomes and capture call audio for quality assurance.

To learn more advanced features that you can use with outbound call centers, see Voice outbound call centers.

Result

After following this guide, you can programmatically place outbound phone calls using Twilio Programmable Voice and the Twilio SDKs. You will have built code that plays TwiML instructions on a call, sends DTMF digits, and receives call status and recording callbacks.

Next steps

Explore the following guides to build on what you've learned in this guide:

Gather user input by using the keypad (DTMF Tones): Use the <Gather> verb to build interactive telephone menus.
Accept payments during calls using Stripe: Integrate Stripe with Twilio to securely process credit card payments over the phone.
Modify calls in progress: Dynamically update ongoing telephone sessions.