--- title: Twilio Sms slug: connectors/twilio-sms docTags: createdAt: 2026-06-09T16:30:15.045Z --- The Twilio SMS connector enables automated communication through SMS and voice calls, leveraging Twilio's robust messaging services. Twilio is a cloud communications platform that enables users to send and receive text messages, make calls, and utilize messaging services through its API. The Twilio SMS Connector for Swimlane Turbine allows users to integrate these communication capabilities directly into their security workflows. By leveraging this connector, security teams can automate notifications, alerts, and responses, ensuring timely and effective communication during critical security incidents. The integration streamlines the process of reaching out to stakeholders and teams via SMS, voice calls, or WhatsApp messages, enhancing the overall incident response strategy. ## Prerequisites To utilize the Twilio SMS connector within Swimlane Turbine, ensure you have the following prerequisites: - Twilio Account SID and Authentication Token for API access: - Authentication Token: Your unique Twilio authentication token for secure API access. - Account SID: The string that uniquely identifies your Twilio account, required for API interactions. ## Capabilities Twilio SMS Connector provides the following capabilities: - Make Call - Send a WhatsApp Message - Send an Message with Messaging Service - Send SMS ## Notes [WhatsApp Business Platform with Twilio](https://www.twilio.com/docs/whatsapp/api#sending-notifications-with-whatsapp) [Send a WhatsApp Message](https://www.twilio.com/docs/whatsapp/api#sending-notifications-with-whatsapp) [Send an Message with Messaging Service](https://www.twilio.com/docs/messaging/api/message-resource#send-a-message-with-a-messaging-service) # Configurations ## Twilio SMS Authentication Authenticates using Account SID and Authentication Token. ### Configuration Parameters | **Parameter** | **Description** | **Type** | **Required** | | ------------- | ---------------------------------- | -------- | ------------ | | account\_sid | Account SID | string | Required | | auth\_token | Authentication Token | string | Required | | verify\_ssl | Verify SSL certificate | boolean | Optional | | http\_proxy | A proxy to route requests through. | string | Optional | # Actions ## Make Call Initiates an outbound call using Twilio's telephony service, allowing for automated voice communication. ### Input | **Argument Name** | **Type** | **Required** | **Description** | | ----------------- | -------- | ------------ | ----------------------- | | `body` | string | Optional | Request body data | | `to` | string | Optional | Parameter for Make Call | | `from` | string | Optional | Parameter for Make Call | ### Input Example `{"body":"Message","to":"+17195551212","from":"+12125551234"}` ### Output | **Parameter** | **Type** | **Description** | | -------------------------------- | -------- | --------------------------------------------- | | `status_code` | string | HTTP status code of the response | | `headers` | object | HTTP headers for the request | | `reason` | string | Response reason phrase | | `account_sid` | string | Unique identifier | | `answered_by` | object | Output field: answered\_by | | `api_version` | string | Output field: api\_version | | `caller_name` | object | Name of the resource | | `date_created` | string | Output field: date\_created | | `date_updated` | string | Output field: date\_updated | | `direction` | string | Output field: direction | | `duration` | string | Output field: duration | | `end_time` | string | Time value | | `forwarded_from` | string | Output field: forwarded\_from | | `from` | string | Output field: from | | `from_formatted` | string | Output field: from\_formatted | | `group_sid` | object | Unique identifier | | `parent_call_sid` | object | Unique identifier | | `phone_number_sid` | string | Unique identifier | | `price` | string | Output field: price | | `price_unit` | string | Output field: price\_unit | | `sid` | string | Unique identifier | | `start_time` | string | Time value | | `status` | string | Status value | | `subresource_uris` | object | Output field: subresource\_uris | | `subresource_uris.notifications` | string | Output field: subresource\_uris.notifications | ### Output Example `{"status_code":"CA5171e01a64104d8df067b21279b0a0b4","headers":null,"reason":"OK","json_body":{"account_sid":"ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX","answered_by":null,"api_version":"2010-04-01","caller_name":null,"date_created":"Tue, 31 Aug 2010 20:36:28 +0000","date_updated":"Tue, 31 Aug 2010 20:36:44 +0000","direction":"inbound","duration":"15","end_time":"Tue, 31 Aug 2010 20:36:44 +0000","forwarded_from":"+141586753093","from":"+15017122661","from_formatted":"(501) 712-2661","group_sid":null,"pa...` ## Send a WhatsApp Message Send a WhatsApp message through Twilio by specifying the recipient's and sender's phone numbers. ### Input | **Argument Name** | **Type** | **Required** | **Description** | | ------------------- | -------- | ------------ | --------------------------------- | | `to` | string | Required | WhatsApp Recipient Address. | | `from` | string | Required | Approved WhatsApp Sender Address. | | `body` | string | Optional | Message Content Text. | | `media_url` | string | Optional | URL of Media to send. | | `content_sid` | string | Optional | Content SID for Message. | | `content_variables` | string | Optional | Variables for Content Template. | ### Input Example `{"to":"+141552xxx","from":"+141552xxx","body":"Hello, World!"}` ### Output | **Parameter** | **Type** | **Description** | | ------------------------ | -------- | ------------------------------------- | | `status_code` | number | HTTP status code of the response | | `headers` | object | HTTP headers for the request | | `reason` | string | Response reason phrase | | `body` | string | Request body data | | `num_segments` | string | Output field: num\_segments | | `direction` | string | Output field: direction | | `from_` | string | Output field: from\_ | | `to` | string | Output field: to | | `price` | object | Output field: price | | `error_message` | object | Response message | | `uri` | string | Output field: uri | | `account_sid` | string | Unique identifier | | `num_media` | string | Output field: num\_media | | `status` | string | Status value | | `messaging_service_sid` | object | Unique identifier | | `sid` | string | Unique identifier | | `date_sent` | object | Output field: date\_sent | | `error_code` | object | Error message if any | | `price_unit` | string | Output field: price\_unit | | `api_version` | string | Output field: api\_version | | `subresource_uris` | object | Output field: subresource\_uris | | `subresource_uris.media` | string | Output field: subresource\_uris.media | | `_solution` | object | Output field: \_solution | | `_solution.account_sid` | string | Unique identifier | | `_solution.sid` | string | Unique identifier | ### Output Example `{"status_code":201,"headers":null,"reason":"CREATED","json_body":{"body":"Sent from your Twilio trial account - Hi testing","num_segments":"1","direction":"outbound-api","from_":"+180xxxxxx","to":"+9177034xxxxx","price":null,"error_message":null,"uri":"/2010-04-01/Accounts/AC99a3b212c43bc6e05d817xxxxxxxx/Messages/SM0fa20d210a655ba9...","account_sid":"AC99a3b212c43bc6e05d817xxxxxxxx","num_media":"0","status":"queued","messaging_service_sid":null,"sid":"SM0fa20d210a655ba9139af31xxxxxxx","date_sent...` ## Send an Message with Messaging Service Sends an SMS to a specified recipient using a Twilio Messaging Service SID and message body. ### Input | **Argument Name** | **Type** | **Required** | **Description** | | ----------------------- | -------- | ------------ | ------------------------------------- | | `to` | string | Required | Recipient's Phone Number. | | `body` | string | Required | Content of the Message. | | `messaging_service_sid` | string | Required | Identifier for the Messaging Service. | | `from` | string | Optional | Sender's Phone Number. | | `mediaurl` | string | Optional | URL of the Media to send. | | `content_sid` | string | Optional | Identifier for the Content Template. | ### Input Example `{"to":"+1415xxxxxxxx","body":"Hello, World!","messaging_service_sid":"MGXXXXXXXXXXXXXXXXXXXXXXX"}` ### Output | **Parameter** | **Type** | **Description** | | ------------------------ | -------- | ------------------------------------- | | `status_code` | string | HTTP status code of the response | | `headers` | object | HTTP headers for the request | | `reason` | string | Response reason phrase | | `body` | string | Request body data | | `num_segments` | string | Output field: num\_segments | | `direction` | string | Output field: direction | | `from_` | object | Output field: from\_ | | `to` | string | Output field: to | | `price` | object | Output field: price | | `error_message` | object | Response message | | `uri` | string | Output field: uri | | `account_sid` | string | Unique identifier | | `num_media` | string | Output field: num\_media | | `status` | string | Status value | | `messaging_service_sid` | string | Unique identifier | | `sid` | string | Unique identifier | | `date_sent` | object | Output field: date\_sent | | `error_code` | object | Error message if any | | `price_unit` | object | Output field: price\_unit | | `api_version` | string | Output field: api\_version | | `subresource_uris` | object | Output field: subresource\_uris | | `subresource_uris.media` | string | Output field: subresource\_uris.media | | `_solution` | object | Output field: \_solution | | `_solution.account_sid` | string | Unique identifier | | `_solution.sid` | string | Unique identifier | ### Output Example `{"status_code":"201","headers":null,"reason":"OK","json_body":{"body":"Hi testing","num_segments":"0","direction":"outbound-api","from_":null,"to":"+91770xxxxxxxx","price":null,"error_message":null,"uri":"/2010-04-01/Accounts/AC99a3b212c43bc6e05d8175daxxxxxxxx/Messages/SM32abf700f3e21...","account_sid":"AC99a3b212c43bc6e05d8175daxxxxxxxx","num_media":"0","status":"accepted","messaging_service_sid":"MGa9c0fb49f844d56420f00b4feaxxxxxx","sid":"SM32abf700f3e2132456f8exxxxxxxxxx","date_sent":null,"er...` ## Send SMS Sends an SMS to a specified phone number using Twilio's messaging service. ### Input | **Argument Name** | **Type** | **Required** | **Description** | | ----------------- | -------- | ------------ | ---------------------- | | `body` | string | Optional | Request body data | | `to` | string | Optional | Parameter for Send SMS | | `from` | string | Optional | Parameter for Send SMS | ### Input Example `{"body":"Message","to":"+17195551212","from":"+12125551234"}` ### Output | **Parameter** | **Type** | **Description** | | ------------------------ | -------- | ------------------------------------- | | `status_code` | string | HTTP status code of the response | | `headers` | object | HTTP headers for the request | | `reason` | string | Response reason phrase | | `account_sid` | string | Unique identifier | | `api_version` | string | Output field: api\_version | | `body` | string | Request body data | | `date_created` | string | Output field: date\_created | | `date_sent` | string | Output field: date\_sent | | `date_updated` | string | Output field: date\_updated | | `direction` | string | Output field: direction | | `error_code` | object | Error message if any | | `error_message` | object | Response message | | `from` | string | Output field: from | | `messaging_service_sid` | object | Unique identifier | | `num_media` | string | Output field: num\_media | | `num_segments` | string | Output field: num\_segments | | `price` | object | Output field: price | | `price_unit` | object | Output field: price\_unit | | `sid` | string | Unique identifier | | `status` | string | Status value | | `subresource_uris` | object | Output field: subresource\_uris | | `subresource_uris.media` | string | Output field: subresource\_uris.media | | `to` | string | Output field: to | | `uri` | string | Output field: uri | ### Output Example `{"status_code":"CA5171e01a64104d8df067b21279b0a0b4","headers":null,"reason":"OK","json_body":{"account_sid":"ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX","api_version":"2010-04-01","body":"Hi there","date_created":"Thu, 30 Jul 2015 20:12:31 +0000","date_sent":"Thu, 30 Jul 2015 20:12:33 +0000","date_updated":"Thu, 30 Jul 2015 20:12:33 +0000","direction":"outbound-api","error_code":null,"error_message":null,"from":"+14155552345","messaging_service_sid":null,"num_media":"0","num_segments":"1","price":null,"...` # Response Headers | **Header** | **Description** | **Example** | | ------------ | ----------------------------------------------------- | ----------------------------- | | Content-Type | The media type of the resource | application/json | | Date | The date and time at which the message was originated | Thu, 01 Jan 2024 00:00:00 GMT |