Make a phone call

Make a phone call

Places an outbound call from a Twilio number to a phone number, SIP address or client and runs the TwiML you give it when the call connects.

Note: --from must be a Twilio number or a verified caller ID. Every completed call is charged, including one a voicemail answers.

Set up

Use the first option your agent supports.

CLI (official)

Install the command, then confirm it runs.

brew tap twilio/brew && brew install twilio
twilio --version

Run twilio api:core:calls:create.

Set $TWILIO_API_KEY in your environment first (get a key: https://www.twilio.com/docs/iam/api-keys/keys-in-console).

Note: Also set TWILIO_ACCOUNT_SID and TWILIO_API_SECRET, with TWILIO_API_KEY holding the API key SID, or sign in once with twilio login.

Before anything else, confirm access with the cheapest read-only call, like a list or a search. Never send or change anything to test access.

Rules

• Ask the user before anything that sends messages, costs money, or changes data, and say how many records it touches. One approval covers a batch the user has seen.
• Never print API keys.